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ABSTRACT 

The main purpose in developing the "package" of 
computer programs described in this guide is to use the automated 
capability of computers in the enormous job of handling 
anthropological field data. It is held that ethnography may be 
threatened with absolescence simply becasue so many man hours are 
involved in filing and sorting these types of data. One section 
discusses the procedures for getting the data from the field onto the 
computer in such a form that the researcher and computer can carry on 
from there nith a minimum of clerk man-hour assistance. Another 
section introduces one to the program package. It gives an account of 
the requirements for using the programs on a computer installation 
and introduces important conventions which explain the reasons for 
many of the rules discussed in a subsequent section nnder key 
punching and copy editing. The next section discusses input-output 
routines and presents in some detail how one, prepares jobs for the 
program package. The last five sections focus on various programs. 
Appendix A describes the procedure for transferring the data to tape 
for long term storage and/or as a duplicate copy. Appendixes B and C 
describes sample uses of the program package. A glossary of program 
package terms appears at the end of the guide. (Author/JH) 
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PREFACE 

This guide is actually the product of the woric and know-how of an 
undergraduate and graduate ''computer'' gene ration • The young men whose 
names appear on the title sheet are the authors of this guide. Burnett, 
the director and principal investigator was first student to their work 
and then editor of the voluioe. 

The idea for developing some means of adapting the computer to assist 
eftknographers emerged during conversations between Burnett and Slotnick 
in 1968. Slotnick assembled the basic package, with the assistance of a 
colleague, Rodney Bussel. 

An early edition of the guide was developed during 1968-69. This 
edition was used by Good, a graduate student in Educational Administration, 
and Hunt, an undergraduate in Engineering, who took over responsibility 
for handling the programs and their modifications as well as testing 
procedures for compilation and processing on data coming in from the field 
as we carried on the study of Fuerto Ricans in Chicago. This involved 
continuing revision of the manual. During this period another undergraduate 
in Engineering replaced Hunt. By the end of the fieldwork phase of our ' 
Chicago study, the guide had been expanded and modified, all progiams had 
been tested on our field data, and certain programs had been modified. 

During the latter part of 1971, Coulthurst changed and modified certain 
of the accessing proceduore. considerably reducing the kna^ledge of Job 
control language needed to use the package for entering, manipulating, and 
processing data. 
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We continue to experiment with and develop the programs • In the 
future we hope to develop and add the EDIT prograu! so that it can be 
used m copy editing data, in performing content analyses, and other 
analytic operations. 

We gratefully acknowledge the financial assistance of the Social 
Rehabilitation Service, HEW, The Bureau of Educational Research and the 
College of Education of the University of Illinois. Vie would like to 
acknowledge with special thanks to the Measurement and Research 
Division of the Office of Instructional Resources for the loan of computer 
time and the willingness to give expert counsel, particularly to Richard 
F. Spencer, Director now deceased. 

Those readers who are interested in obtaining copies of the source 
programs and object deck for BEDRES should contact Jacquetta H. Burnett, 
Bureau of Educational Research, University of Illinois, Urbana, Illinois, 
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1. INTRODUCTION 

1.1. Purpose of Conguter Assisted Frocessinr of Ethnographic Data and the 
Guide. 

The main purpose in developinp the BEDRES "packape" of computer proprans 
described in this guide is to enlist the autonated, clerical facilities 
of the computer to perform indices » concordances and limited analyses 
of data recorded in natural lanpuape (in our case in both English and 
Spanish). Part of our cime has been spent in developinp efficient, vzorh- 
able procedures for preparinp the data to be "loaded" onto the computer. 
In addition, many months were spent, not only in creatinp (boch throuf^h 
borrowinr and inventinp) proprams that would file and sort data, but in 
working the "bugs" out of the initial programs ao that the final programs 
worked precisely and reliably. This phase of the computer use-developmert 
took an unanticipated two years. During the final phase we have reduced 
to a minimum the knowledpe of job control lanpuape needed by a user of the 
system. 

We have accomplished the fir^t objective in the , plan |or computer 
assisted processing of ethnographic data (CAPED): A researcher alone, 
with perhaps a part-time data processing clerk, the BEDRES Program deck, this 
manual, and a few hours with a proprammer each week, can learn to continue 
to rework the data in the direction of receding, standardizing;, and 
i^ystematizing it on theoretically sipnif leant prounds. 

!Iost important, the initial conpilation by the computer retains the 
open-ended, "serendipituous" character of the ethnopraphic field data, 
in which observations first are coded , so to speak, in a natural lan^uape 
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system, for example, English or Spanish. This feature of our CAPED design, 
seetned particularly special because most of the use of computers in anthro- 
pology has involved *'auton>atic*' classification, or pre-codif ication, prior 
to its being loaded on the computer.'^ Ue have moved coniputer loading back 
a step, and have provided a means of entering data 'coded'' in natural lan- 
guage as it has traditionally been done in ethnographic field notes* the 
* second and third levels of abstraction, through recoding , are done not in 
the field, but by the researcher on the computer with the clerical aid of 
the computer. In other words, the same ethnoj^raphic data can be reworked 
numerous times according to several different possible theoretical schema, 
without high additional investment of man-hours of work, after initial proc- 
essing and loading onto the computer. 

In the simplest terms and at this stage it has been our purpose 
to enlist the computer's automated help in the enormous clerical job of 
processing anthropological field data. Some commentators frankly, are 
impatient with^ even contemptuous of, the mere clerical use of computers, 
in filing and sorting. They press on with the desire to use this sophisti- 
cated equipment to assist in systematization of theoretical significance. 
While cne can appreciate the concern to link formulations familiar to 
anthropologists uith formulations involved in sophisticated computer proc- 
esslng so as to facilitate significant data reduction, automated clerical 
help in processing ethnographic type data can be of enormous value to the 
employment of that data in systematizing anthropological inquiry. 

After my own experience with processing ethnographic data in two dif- 
ferent field studies, I became increasingly doubtful that natural history 
accounts of human behavior, which is what ethnographies are, could survive 

*See Dell Kymes, ed.. The Use of Computers in Anthropology , Mouton & Co., 1965, 
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as a research procedure in a high labor-cost economy. Ethnography could 
become obsolete simply because so many man hours are iiivolved in filing 
and sorting this type of data. Moreover, often there is a very lox7 ratio 
of the amount of information retrieved (not necessarily the significance 
of the information ) to each man-hour of work on ethnographic field data. 
Perhaps this set of programs v/ill help carry ethnography into the era of 
automation • 

1.2 Contents of Guide 

Compilation of the data, filing, and sorting* involve proprars 
that index and perform concordances of the data. In the BEDRES program 
package, these "accounting services" are perforrad by IKDEX and C0I^C0RD. 
Indices are defined in this package as alphabetized listings of all the 
different words appearing in the data and the indication of the sentence 
numbers and files in which they appear. The concordance program utilizes 
the indices to list and print--out» on command, those sentences in the 
data which contain specific words or constellations of irords, as well as 
a certain number of sentences preceding and follo\;ing the target sentence. 

To obtain an index however, BEDRES employs two programs: LISTER, 
which produces a list of all the words in a text: INDEX, which then, 
locates each word (or phrase) by the number of the numbered sentences (s) 
in the text where it occurs, C0\C0RD can then be used to "retrieve" and 
print -out the sentence context, or paragraph, in which a word or phrase 
appears. This procedure aides retrieval of meaningful, or context defined, 
information. 

For example, if we wish to obtain certain information about a given 
individual, we can use LISTER, INDEX, and C0KC0RD in concert to locate that 
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information. LISTER and INDEX give one all the locations of mentions of 
a certain person. C0WC0RD, then narrows down the search by givinp a bit of 
each context in which the person *s name appears. IJith these hints one can 
narrow the search by setting up a priority list of the remaining most 
l^^^^ly locaticnsof the information wanted. Then through ordering a print- 
out of the full file, for each of the most likely locations, in order of 
priority, the researcher can locate the correct context. 

EDIT is initially used to load data on to the computer from cards. 
EDIT acts as a filing system for data as v^ell, since it requires that all 
data be labeled by date and type of source (f ieldnotes or interview) . Each 
set of data is also assigned unique codewords so that any operations per- 
formed on a dataset trill not affect other data on the computer. 

EDIT is a utility routine that is of major significance to the further 
analysis of ethnographic data once it is copied onto the computer, and 
indices and concordances have been done. We intended to use EDIT to help 
us with copy editing the text of the fieldnotes that x;as on the computer 
disk. EDIT, as now written, is too cumbersone for this use. EDIT, however, 
is used to separate portions of data from other portions this, allows the 
research to retrieve selected information pertaining to one person, one 
event, or one category, host importantly, because EDIT can change indi- 
vidual words, phraser, and senterc?^ in a file, it can be used to recode, 
or to standardize, descriptive accounts of items or events which concep- * 
tually are classed as the same. This is an important iinalytic step beyond 
mere filing, sorting, and locating. 

Finally, EDIT is used to concatenate files, such that several small 
files can be put together in one large file. It is used to reorder 
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datasets into different relationships to one another. We use EDIT 
to put all our datasets into chronolop^ical order* Thus, EDIT is the 
star program in moving CAPED beyond the compilation stage. 

The following chapters describe not only the programs of BEDRES, but 
also in Chapter 2, the procedures for gettin<> the data from tbe field onto 
the computer in such a form that the researcher and computer can carry on 
from there, with a minimum of clerk man-hour assistance. (Indeed, remembiir 
the computer is also a typist of it« stored texts.) Chapter 3 introduces 
the reader to the BEDRES Program package. It gives an account of the require* 
ments for using the program on a computer installation and introduces 
important conventions which explain the reasons for many of the rules dis- 
cussed in a subsequent chapter under keypunching and copy editing. Chapter 
4 discusses input and output routines, and presents in some detail how one 
prepares jobs for BEDRES, Chapters 5 and 6 discuss "Load EDIT" and EDIT. 
LISTER, INDEX, AliD C0I4C«)RD are cjiscussed in Chapters 7, 8, and 9. Appendix 
A describes the procedure for transferring the data to tape for lonp, term 
storage and/or as a duplicate copy. Appendixes B and C describe sample uses 
of BEDRES. A Glossary of BEDRES terms appears at the end of the guide. 

The initial sections of the guide from the "Introduction" through 
"Input/Output Routines and Job Preparation" will p;ive the reader a picture 
of CAPED as we developed it for this project. The other sections are 
probably more easily read and understood as the individual user adapts 
the package to his ovm use and computer installation. 
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2. PROCESSING FIELDliOTES FOR COMPUTER ENTRY 



2.1 Outline of Procedures 

Developing efficient , workable procedures for processing ethnographic 
data so that it can be **loaded** on the computer was a major job in the 
development of our GAPED. Preparation procedures were contingent not only 
on the set of programs used to compile and organize data, but also on the 
type of user services available from our computer installation. For 
example^ during the first year of the project, our installation offered 
a remote terminal and disk sharing service which we tried to adapt to our 
use. As matters developed , it became more efficient to punch and copy 
edit cards for loading onto the computer. 

Creation and development of programs for a "package'* involved hours 
of trial » debugging, retrial, and re-debugging. The trials Involved 
'^experiments*' with samples of data. But tfe did not use samples of our 
field data, until the program, or programs in combination, had worked 
well on more standard types of data. The design for the final stages of 
processing for computer loading had to wait until we were sure the package 
would work, at least, through the compilation stages. In the meantime, 
as fieldvork produced data, we used a traditional man-hour system of filing 
and cross-filing in file cabinets. As the GAPED system became more effi- 
cient, more and more of these traditional, hand-operations were dropped, 
and we began to transcribe tapes rnd handwritten notes directly on to the 
cards by keypunching (i.e., we dropped out section 2.3.2). 

The procedures described in this chapter include the "hand" operations, 
as well as the computer dependent operations. We have starred those steps 
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that could be dropped out once the programs were reliable and Indices and 
concordances were being printed out by the coiuputer. 

In the first section of this chapter we outline and diagram the 
processing procedures- the rest of the chapter spells out these steps in 
detail. As a whole, the chapter covers all those steps followed after 
the fieldnotes ais collected and labeled up to the point at which the 
BEDRES program takes over. 

A flow chart for processing fieldnotes might be outlined as follows: 
Phase I. Labeling fieldnotes received from the field. 
Duplicating for cross-filing. 

a. Principal sample file 

b. Author file 

c. Date file (see phase IV) 



Phase II. 



Phase III, 
Phase IV. 



Phase V. 



Check off scheduled interviews corpleted. 
Processing of date-file copy for computer storape. 

a. Editing original text 

b . Keypunching 

c. Listing 

d. Editing printout 

e. Correcting cards 

f. EDIT cards onto disk 

BEDRES Program processing of ficldnote data sets. 

a. LISTER 

b . INDEX 

c. Concatenation 

d. C0NC0RD 

These steps are diagramed in Figure l, pp. g-]2 
2*2 Coding Co mputer Files to Hold Fieldnotes 

2.2.1. File all fieldnotes by "name" so they can be entered 
on the volume table of contents. The names of che 
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Ftgtire 1. 

Phase I 



Flow chart for processing £ieldnotes. 

( ' START ) 



I Materials received from 
workers in Chicago. 


r 


7 


r ■ ■ 

Label fieldi 
author, date 
code (i.e., 


\ 

lotes by ; 
ly and type 

JB06109A) . ! 

. 1 




Transcribe taped notes onto 
8 1/2 X 11 paper, making 
4 copies. 



Xerox 3 copies of original 
notes. 




Phase II 



Cross-File Copies 

a. 1 copy to principal sample folder 

b. 1 copy to author file 

c. 1 copy returned to author (fieldwrker) 

d. 1 copy (date copy) for keypunching 
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Fi«?ure 1 , Cont'd. 




Phase III 



r 



Up-date office record of 
interviev/s completed. 



Phase IV 



Proofread fieldnotes 

a. Indicate Part and Section No. of Interview 

b. Correct typographical errors 

c. Put in question numbers 

d. Indicate semantic units 

e. Observe conventions of hand editine 



See: Instructions 
for hand 
editing 
punched 
cards . 



Keypunch, proofread fieldnotes 



List punched cards on IBII 360/20 



Edit and correct punched cards 



See: Instructions 

for keypunching 
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Fl{»ure. 1, Cont d, 

r 

2 



Phase IV, Cont'd , ^ 

V - 

Load the corrected fieldnotes on the disk 
pack. 

a. Use EDIT for loading 

b. Use LISTER for printing 

c. Use INDEX for referencing the file names 



Up-date data-set records. 



b. 



Arrange file name cards in same order as 
on print-out 

Indicate location of fieldnotes within 
data-set by sentence number 



c 



Concatenate fieldnotes in desired order (e.g., 
by date) . 

a. Use EDIT for building date files 

b. Arrange records with LRECL«72 



0 
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Figure 1, Cont'd 
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LISTER and INDEX, the date-ordered files. 



Copy the data-set on the disk onto the tape 
for a back-up copy. 



Further analysis of data using EDIT and 
C0NC0RD to partition data-sets and examine 
content. 



3L 



17 



12 



FlRufe ir^.Cont'd. 



File proofread original of fieldnotes in 
the data file. 



^ STOP J 
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files used to put field notes and interviews on the 
conputer aust: 

a. Begin with an alphabetic character (A*Z) and 

b. Be no longer than eight characters* 

2 .2 .2. The name of a file will reflect: 

a. The interviewer *s initials » first and last name only» 

b. The date of the trans act ion » and 

c. The type of data that is to be input • 

2»2,3* Using a set of eight characters to name each file» characters 
1 and 2 should consist of the intials of the first and last 
name of the staff person who has written the data set. 

Characters 3» 4» 5» 6^ 7» represent the transaction; 
i.e., characters 3 and 4 are the month of the interview 
varying from January (01) to December (12), i«e«» characters 
5 and 6 are the day of the interview (01-31); and the 7th 
character is the numeric character of the year (0-9) » but for 
the purpose of our research project 1969 is represented as 
9, and 1970 is 0. 

Character 8 (or the last character) is an alphabetic 
code Indicating the type of data being treated: 

Fleldnotes - (A-L): These include narrative accounts 
by fieldworkers of descriptions of events » extempora-* 
neous interviews » or the account of the course of 
their day. 

Interview transcripts • (M-Z): Are the accounts of 
the scheduled interviews with the principle saniile 
youths and their social networks. 

19 
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2.2 A. Each file can take up 999 llnea or leas on the computer « 
Therefore^ if a set of data will run more than 999 linea 
you ahould atart another file with the aame baaic nacie 
and dtange only ihe last character of the name to the next 
alphabetic character* 

2.2.b. An example of a file name for fieldnotes ia: 
JB102O8A 

Thia file contains data from Jacquetta Burnett (JB) that 
waa written in October (10) on the 20th day (20) in the 
year 1968 (8). The file contains written material of the 
fieldnotes type (A). If this file gets filled (i.e., runs 
to 999 lines) before the end of the fieldnotes » another 
file ahould be opened that is named: 
JB10208B 

Whare B at the end Indlcataa tba ae,c o n d file for Burnett ^a 
fieldnotes on the 20th of October 1968. 
2,2^6» An exaiq^la of a file name for interview data la: 
SH02059M 

This file contains data from Sally Wolfe's (SW) work in 
February (02) on the 5th day (05) of that month during the 
year 1969 (9) • The file contains data of the interview 
variety (M) . If the 999th line of the file was filled and 
there were still aore data to come you would open a new 
file named: 
SV020S9N 

Where N shows that this file ia the second one for Wolfe's 
work on that particular date. 

ERLC 
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2.2.7. If a field staff person generates data fro© ©ore than 
one person or more than one interview schedule you should 
open the next logical file for each new set of data. 

2.2.8. In 6 above no spaces should be left in the name of the 
file. Remember that the computer interprets a blank 
space as a character* 

2.2.9. Write out completely words that are commonly abbreviated, 
such as street, avenue » company, doctor, etc. Abbreviations 
for Mr. and Mrs. may be used, but without the period 

(Mr & Mrs). The abbreviation U.S»A. may be used, but 
without periods and ^^thout spaces between the letters 
(USA). (US, however, may not be used because of possible 
ambiguity.) 

2.2.10. The first appearance of a semantic unit, a set of two or 
more words that must be used together to convey a unitary 
meaning, should be enclosed thus: <Mr. Gonzales>. For 
each file of up to 999 line, it is not necessary to 
continue this procedure after the first appearance of 
each individual unit however; but each different unit 
will have to be bracketed on first appearance in each 
file. 

•3 Preparing Fieldnotes and Interviews for Computer 

2.3*1. The tapes are logged in by four different procedures. 

1.1. They receive a file number (one person is assigned 
to do this) . 
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Exainple: S\'/09220A 

SW « Author's Initials 
09 » month 

22 « day of the month 

0 « last digit of the year, l,e,, the 
date the notes were written. 

The V designated that the notes are "Fleldnotes and 

if it were an "M*' it would designate the notes as 

"Interview Notes." (A - L « Fieldnotes; M - Z « 

Intervl«7 Notes.) So, the author is Sally Wolfe, 

the notes were written on September 22, 1970. If more 

than one interview Is done in a day, then an ''N,*' then 

an "0/* and etc.. Is assigned to each subsequent 

interview. 

• 1*2. The file number is then put directly on the tape 
cassette with a sticky labels Then, the cassette 
Is put on the top shelf of the file box marked 
'"Taped Notes Received/' 
.3. The new file number (SW09220A) is typed onto "Copy- 
zip'* paper and then entered on the large Log Sheet 
under "Taped Notes Received." 
(See Figure 2 for example.) 
.4. One person, so assigned, will keypunch an IBM card 
for that set of fleldnotes (SW09220A) and will put 
the card in a metal file drawer marked "Files Not 
Yet on the Disk" in order of person and date, 

22 

o 

ERIC 



If 



OQ CO 



o 

fl> 

s 



IS 

B 
o 



H 


r* 




CA 














^ 




n> 


0» 


fl) 


f= 


ri 


H» 


(U 




o 


O 


»1 






(t) 


M 


n> 




(0 


§ 
















^Llano 
























O 








ON 
















Ol 








O 


















CA 










o 






o 


CO 






00 
























vD 








*— • 




r* 










^ 






O 


O 








ON 








H» 








Oi 






o 


O 












a 




CA 






CO 


»TJ 


^ 


M 


o 


H» 




lO 




H» 


O 


M 






H» 


vO 


o 




H» 


vO 






vO 


> 









c 

N 



rs^ 

ess 

o o o 

ON Ln 
o ro ro 

VO O 

o o o 
'Tj 2s 



O O 
O O 

o o 

VO vp 

w > 



23 











• 
















• 
























W 

3 








IV 








ft 








rr 








Ch 


W 25 


H 




n> 


0 


0> 




o 


rr tJ 


Ok) 


(D 


n) 


(D 


o 




CO 


a 




< 














#«-• 












s: 




n> 


0 






0 


ft 


H- 




n> 


n> 


rt 






CO 


rt 




< 




fl) 








P 




CL 








H 








n 
















D 








CO 








0 








n 
















o* 
















0. 






Ch 


td 


0 


W 




H- 


D 


P 


O 


CO 




ft 


OJ 






fl) 


M 






ri 








(D 








CL 




















M 








0 








C 








►0 








A) 








a. 














t=i 








0 








M 








H 








































M 








PI 








































n 























o 

CO 

sr 
fl) 
o 



o 

fl) 
fl) 

•o 

D 

OQ 

H 

n 
o 

H- 

fl) 
M 
Cu 
D 
O 



fl) 
(0 



ERLC 



18 

2«3«2. The tapes are then transcribed. Four copies will result 
(one original and three carbons). 

•2.1. The original goes to Burnett for editing. They are 

placed In the bottom shelf of the metal trays on 

the left side of her desk. 
• 2. One copy goes back to the author (usually sent to 

Chicago if that Is where the author Is located). 
•3. One copy la filed In the Fleldnotes File under the 

author's name. 

•4. The last copy goes In the principal sample file (In 
metal file cabinet). If, however, the fleldnotes 
make no mention of any of the Principal Sample, 
the last copy should be filed under miscellaneous^ 
2.3«3, After the notes are transcribed the person who transcribes 

them will transfer the file number sticker (SU09220A) on the 
Log Sheet from the "Taped Notes Secelved" coluon to the 
"Transcribed" column. 
2 •3*4. After Burnett edits the original copy, it is placed in the 

tray marked ''Notes to be Entered on the Disk," third section 
from the top. 

2.3.5. Entering data on disk: keypunch card method. 

.5*1. Two cards are punched for each set of fleldnotes with 
the File Name of the notes. (See 2.2.1 - 2.2.6 above.) 
.1.1. On the first card the file name begins with 
the first column (cc 1). Thia card must be 
placed in the file drawer marked DATASET 
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RECORDS to keep track of the tcbU of 
Qontents of fieldnotes that have been 
Bent to Ike conputer. 

f 

•1,2, On the second card> indent five spaces and 

?* J* ' 

begin punching file name in the sixth space 
(cc 6) • A period roist be placed after the 
file name. This card becomes the first 
card of the deck. 
• 1.3. Regarding keypunching dififds after the title 

cards, see. "Insittuct ions for Keypunching: 2.4.*' 
.5.2, After the interview or fieldnotes have been punched, 
put the punched cards in the card file drawer under 
interview name . (Be sure the first card is pot in 
* the Dataset Records drawer.) Put the draft you 

punched from on the file shelf, "Copy to be Logged.'' 
.5.3. T6 copy-edlt your punched cards, take the punched cards 
to the Digital Computer Laboratory, and get printout 
on the 1MB 360/20. Edit this according to instructions 
in "Instructions for Hand Editing Punched Cards." 
Then change your cards to correspond to the edited 
printout. THIS STEP MAY BE SUBSTITUTED FOR VERIFYING 
STEP. 

.5.4^ Put copy-edited cards in file drawer "Punched Fieldnotes 
to be put on disk" (BEDRES) . Put edited printout In 
file shelf labeled "Correspondence" with note indicating 
that cards are ready for BEDRES. 
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Proctss for Written Notes Received 

•8,1, Written noteo are given a file naoe which it then 
pieced on the '"log Sheet under 'Vritten Notee 
Received." 

•2. The notee ere then »roxed (one original end 3 coplee) 
and distributed exactly the eene way as the typed 
transcribed notes, 

•3. After Burnett edits the original copy it is placed 
in the tray (third from top) for entering on the 
Diek. ("Notes to be Entered on the Disk/') 

•4. The notes are then entered on the Disk eccording to 
the directions in Chapter 6 under '"Load Edit/* 

•5, After the notes are on the Disk» the file nuiber 
(SW09220A) is transferred to the '^Entered on Disk** 
colunn on the Log Sheet, 

•6, Should the user decide to group two or note sets of 
fieldnotes under one file naw> this should be 
indicated in the ^'grouped" colun on the logsheet. 

2*4. Ipf t;nictiens for Keypunching 

2.4 a. TWO cards are punched for eadi set of fieldnotes with the 
file naae of the notes. 

• l.l. The file nsae is nade up of the interviewer's Initials 
snd the date that the interview or fieldnotes were ttade« 
(See 2.3. Preparing Fieldnotes and Intervlewa.) 

.1.2. The firat card: 

.2.1. Begin the file nene in card colunn one (cc 1). 
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• 2. This card naist be placer) in the file draper 

iiarked, DAIASET RECORDS, to be used as a refer- 
ence card for the interview or fieldnotes which 
aze sent to the computer* 
•1,3. The second card: 

•3.1 • Indent 5 spaces and begin the file name in the 
sixth space (cc 6). 

•2. A period liUST be placed after the file name. 

• 3. This car^^ must be the first card in the deck* 

It is the title card for the fieldnotes. 
2.4.2. Rules for keypunching all other cards punched after the title. 
.2.1. If you are punching an interview schedule on the card 

following the file name card you should punch the •'Part" 
niuEber, "Section" number, name of Interviewer; followed 
by a period. Move to the next card to begin the text. 
.2.2. Each new question or paragraph of the interview begins 
on a new card Indented 5 spaces. The BEDRES programs 
will then Esake each question the first word of a new 
paragraph for easy reference. Also, for fieldnotes 
begin each new paragraph on a new card in column 6, 
for the same reason. 
.2.3. Around each question nunber put in semantic unit 
indicators (<>). It helps to set the number off 
as a single word. The semantic unit Indicators are 
also placed around special words or groups of words 
which taken together mean something different than 
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when used separately. The BEDRES programs create 
a list of these semantic units for easy reference • 
Semantic unit indicators are only put around 
the words the first time they are used in each 
interview or set of fieldnotes (i*e,, in each data set 
that begins with a file name). The BEDRES programs » 
throu^ INDEX, automatically list all of the sentence 
numbers where the semantic unit is found even thou^ 
the semantic unit indicators are only put around the 
semantic unit the first time it is used. The semantic 
unit should be two or more words long, since the INDEX 
program gives a listing, by sentence number, where all 
individual words may be found. Semantic unit Indicators 
should be put around: 

•3.1. Specific names of people including first and last 
names; nationalities, gangs, etc. 
Example: <Louis Rodriguez>, <North American>, 
<Latin Kings> 

.2* Schools 

Example: <Von Uumboldt>, <Lane Tech>. 
.3. Word references to education; college trade 

school, primary, grammar, grade, etc. 

Example: <double promoted>, <U of I>, <auto 
mechanics>, <third grade>. 
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.3.4. Welfare offices 

Example: fNorthside Welfare Office> 
.5. Street Comers 

Example: <Birch and Maple >. 
.6. Restaurants 

Exanqple: <Kelly's Chicken Inn> 
. 7 . Foods 

Example: <Rice and Beans > 
•8. Idiomatic phrases 

Example: <acid trip>, <running board>, 
<side swipe>, <real buminer>, 
keeping cool>, <bi8 hearted>. 
.9. Names of Interview Schedules 

Example: <Part IV, Section I>. <Par€nt 

Interview Schedule >. <Migration 
and Adjustment Questionnaire>. 
2.4.4. The first integer of the question number that is followed 
by a period indicates the main question. Example: 15.0.0, 
15 is the main question number. When there is a second nutri>er 
following it, the second number indicates a variation on or a 
subpart of the main question. The second number in turn ends 
with a period. If there is a third number following it, the 
third number indicates a variation on the variation or a 
subpart of the first subpart of the main question. The last 
number does not end with a period. Example: ^15.2.1>. If 
there are no variations on the main question it may be written 
<15.0.0> or <15>. 
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2.4.5. Initials are used in the interview to indicate who is speak- 
ing. For every change in speaker begin a new card and indent 
to start in column 6 with the intials of the speaker. After 
the initials, add a colon, and skip two spaces before adding 
content . 

2 .4 .6. Periods followed by a space always mean the end of a sentence 
or a thought. The file name card, every sentence, phrase or 
one word remark must end with a period. Without It the remarks 
that follow are added to the preceding sentence. On the other 
hand, there are no periods after abbreviations unless that 
abbreviation also ends the sentence. 

2«4.7. Decimal points may be used in indicating money, etc. They do 
not act as periods since there is a character in the space 
immediately following it. Provided the period is followed 
immediately by some character it acts as a decimal point and 
not as the end of a sentence. 

2«4,8. All reference to time should be changed to the 24 hour clock, 
thus eliminating the confusion of A.M. and P.M. 
(i.e., 3:00 P.M. « 1500.) 

2.4.9. Quotation marks at the end of a sentence must be followed by 
a period, question mark, or exclamation point. Example (".), 
("?), ("I). If these were reversed to etc., the BEDRES 

program would end the sentence with the period and add the 
quotation mark at the beginning of the next sentence. 
2.4.10. Skip two spaces after a period before beginning the next 
sentence . 
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2*4*11* You may end a word in column 80 of a card, and begin a new 
word on column 1 of the next card. The computer will 
automatically skip "a space • 

2«4.12. If you cannot fit an entire word on a card you may put a 
hyphen at the end of the letters on the first card and 
continue the word starting on column one (CCl) of the next 
card. The BEDRES programs will make the word whole again 
on the printout. The word need not be divided into syllables 
since on the printout the word will be properly reconstituted* 

2*4. 13. If a word contains a hyphen but cannot fit on one card, put 

a hyphen to indicate the rest of the word is continued on the 
next card, and another hyphen on the next card to indicate the 
word is hyphenated. 

2*A»1A» If you make an error such as leaving out a word, type a new 
card and insert the v;ord; whatever will not fit on the first 
cardy put on another new card immediately following the cor- 
rected one. The BEDRES programs will not leave a large gap 
but will adjust the sentence to normal spacing. 

2*4.15. After the interview or fieldnotes have been punched, put the 
punched cards in the card file drawer under the interviewer* s 
name and put the original draft you punched from in the file 
shelf, **copy to be logged.'' 
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2,5. Instructions for Hand Editing Punched Cards* 

2.5a. Arrange the punched cards in chronological order by author. 

2.5.2. Take the punched cards to the Digital Computer Uboratory 
and get a printout on the 360/20 (or listing of cards). 
Ask the 360/20 operator to begin each set of fieldnotes 

at the top of a new page. The hand editing can be done from 
360/20 printout cid then the cardc must be changed to cor- 
respond to thn edited printout before they are loaded onto 
the storage device. 

2.5.3. All editing marks should be made in red pen to catch the eye. 
Circle incorrect spelling or punctuation and note above the 
error what change should be made. 

2.5.4. The first line of the listing of punched cards should be one 
word, one sentence, paragraph, indicating the author of the 
interview or fieldnotes end the date it was made. This is 
the file n ame , and the title for those notes. Each file 
name should be Indented 5 spaces, end with a period, and 
NOTHING ELSE SHOULD FOLLOW ON THAT LINE. 

2.5*5. In fieldnotes that result from interview schedules each question 

answered must have a number. If numbers have not been indicated, 

check the loose-leaf notebook entitled ''EPIC Questionnaires," 

find the corresponding intended; schedule and decide which 

question is bci-^.j arswercd and put the number by the question, 

*The editing instructions that appear here have been covered in the previous 
section on keypunching. They are repealed here so that the relation of 
earlier directions to editing ±3 clear and so that editorial directions are 
consolidated in one place, for purposes of instruction. 
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The question nuinber shovld begin a new line and be Indented 
5 spaces. The first question nusber indicates the loain ques- 
tion and is followed by a period when there is a second nunber 
following it. The second nuaiber indicates a variation on or 
a subpart of the main question. The second nunber in turn 
ends with a period if there is a third number following it. 
The third nunber indicates a variation on the variation or 
a subpart of the oain question. The last nunber does not 
end with a perW, Example <l5.0.O> or <15>. 
2«5.6, Semantic unit indicators 

.6,1, Around each question nunber there must be a semantic 

unit indicator. They help to set the question off. 
•6.2. They should also be placed around special words or gtoups 
of words which taken together laean something different 
than when used separately* Semantic unit Indicators are 
only put around the words the first time they are used 
in each interview or set of fieldnotes, i#e., each data*- 
set that requires a file name. The BEDRES program can 
automatically list all of the sentence nuobers where 
the semantic unit is found even thou^ the semantic 
unit indicators are only put around the semantic unit 
the first time it Is used in each data set. The 
semantic unit should be 2 or more words long» since 
INDEX gives a listing, by sentence number, where all 
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individual words may be found • Semantic unit 
indicators should be put around: 

(1) Specific names of people: nationalities, 
gangs, etc. (See the section on k^pundi- 
ing instruction for specific examples.) 

(2) Schools 

(3) Word references to education; college; 
trade school, primary, grammar, grade, etc. 

(4) Welfare offices 

(5) Street corners 

(6) Restaurants 

(7) Foods 

(8) Idiomatic phrases 

(9) Names of Interview Schedules: 

<?art IV, Section IV>, <Formal Education 
Ques t ionnai re > 

2 .5 .7. Initials are usually used to indicate who Is speaking. Every 
change in speaker should begin a new line indented S spaces, 
and followed by a colon. Two spaces should be skipped after 
the colon before content Is added. 

2.5.8. The first few lines of a dataset should indicate the interview 
part and section being given. It should be described with a 
number, and with the title for that interview sdiedule. If 
this has not been indicated, decide what interview schedule 
the questions are part of and find a blank Interview schedule 
that covers those questions, 

2.5.9. Correct all misspelled words. 
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2.S.10, Check for other pun .cuation conventions. 

•10.1. Quotation marks at the end of a sentence must be 

followed by a period, question mark, or exclamation 
point. Examples (".) ("?) C'l). When this convention 
Is reversed to (•*') etc., the conputer ends the sentence 
with the period and adds the quotation mark at the 
beginning of the next sentence. 
.2. The title, every sentence, phrase or one word remark 
must end with a period. The period indicates the end 
of something. Without it the folloi^lng remarks are 
added to it. There are no periods after abbreviations 
unless that abbreviation also ends the sentence* 
•3. Decimal points may be used in indicating money and 
other figures where needed so long as the point never 
ends the nundber but Is followed by some character* 
They do not act as periods since there Is a character 
in the space immediately following it. 
2,5. 11» All references to time should be changed to the 24 hour clock, 

thus eliminating the confusion of A.M. and P.M. 
2»S.12. Cross out portions that have been duplicated due to keypunching 

errors that were not removed before being printed out. 
2«S.13« Edit cards to correspond to edited printout. Put the cards in 

the file drawer "punched fieldnotes to be put on disk" (BEDRES)* 
Put the edited printout in file shelf ''CORRESPONDENCE" with 
note indicating cards are ready for BEDRES. 
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3. THE BEDRES PROGRAM PACKAGE 

3,1 Proi^rammlng Lanf^uage 

The BEDRES Package programs are written In IBl! Basic Assembler Language 
(BAL) for use on IBM System/360 computers*, though th^ user need not be 
familiar with assembler language programming. Because basic assembler 
language was used, the functioning of the programs is fasten and more 
efficient than would be the case had some other programming language been 
U8ed« Further, the functioning of the projrrams is independent of the 
operating system used by any given conq>eter installation. 

3,2, Package Conventions: Preparing Data for Entry 

The package utilises a minimum of conventions, some of which are dis- 
cussed in the chapters for each of the programs. Those conventions xAich 
are relevant to keypunching and editing data, or to explain why certain 
editorial procedures must be followed. 

Paragraphs are defined as being indented five spaces (five blank 
card columns). Periods followed by blanks or at the ends of lines are 
taken to indicate the ends of sentences. Thus, abbreviations and numbers 
cannot end with periods. Periods embedded within strings of characters 
(as ABC. DEP or 123. A56) are not taken to indicate the end of a sentence. 
£2aaSa cannot be used to separate thousands, for example, from hundreds: 
10,000 is not recognized as ten thousand, but as "ten comma zero-zero-zero." 
Consequently, commas should not be used with numbers. Hyphenated wnrH^ may 
appear at any point in a line or a card (i.e., a record) as long as the 

*lk>del8 SO and up. 36 
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Table 1. Legal Characters for the BEDRES Package. (Con't.) 
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Figure 4 Steps followed in uslnp, the BliDRES Pnckai^o. 
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hyphen 18 not the last character In the record. Hyphens appearing as the 
last character In a record Indicate that the word preceding the hyphen Is 
contlnuea on the next record. If a word cannot be completed In the remain- 
ing space on the record » the hyphen can appear anywhere in the word, not 
necessarily between syllables. It, of course, mist be the last nonblank 
character in the record. In addition to dividing words, hyphens are used 
to represent dashes* Dashes should be represented by two or more hyphens 
with no intervening spaces , Nuirf)ers following letters with no intervening 
spaces are taken as words. Thus IIAIU*' and "!IAN2" are both recognized as 
words. 

3.3# Esoecution of Programs 

The programs in the package can be executed from source programs, 
object modules stored on a storape device such as a disk, object decks, 
or load modules. In this manual, it is assumed that the programs are to 
be run from a load module stored on a device such as a disk. The instruc- 
tions for the preparation of a load module are found at the end of this 
chapter. 

For storage the use of tapes and disks is strongly recommended- 
natural language data tends to be voluminous, and the use of a disk or 
tape will prove to be less expensive than the use of cards in both physical 
energy expenditure and input/output costs. 

Figures 2 and 3 represent the steps usually followed in using the 
BEDRES Package. At the top of Figure 3 the source programs, orijUnal 
versions of the programs, are shown being keypunched and assembled by the 
computer. Essentially, the assembly "translates the programs into code 
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5, Overlay structure for the liEDRES Package. (Boxed words are 
program names. The root section is utilized each tinie a 
branch pr ^-r^^r. is executed. See the text of the following 
chapters for the functions performed by each program in this 
figure • 
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that can be executed by the computer. The assembly results in a source 
listing , a printed indication of the translation and, in this case, an 
object deck , cards containing the assembled program. The user should 
consult his computer installation to determine the procedure for assem- 
bling programs. 

The object decks are then used to prepare a load module (assenbled 
forms of the programs properly linked together). After the object decks 
and control cards are prepared, they are submitted to the computer which 
produces the load module and stores it on a device such as a disk pack. 

In Figure > the data are being collected preparatory to being 
keypunched. Simultaneously, planning is taking place regarding how the 
data will be processed (bottom left). Vlhen the data has been collected 
and the planning conq)leted, the data, control cards, and program cards are 
keypunched. (See Qiapter 2 for keypunching instructions and Chapter 4 for 
control and program card descriptions). At the upper center of the page, 
the job deck has been prepared (see Chapter 4 ) using the data, control, 
and program cards. The job deck is then submitted to the computer (upper 
center). In the event of an unsuccessful run (bottom right), errors are 
corrected and the job deck is again prepared. The successful run (rigjht 
center) is self-explanatory. 
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4. BEDRES INPUT/OUTPUT ROUTINES JOB PREPARATION 



4.0 Input/Output Routines 

BEDRES monitors all execution of the package program. It is the 
program that reads the program control card indicating which program the 
user wishes to execute. It also does preliminary scanning of the parameter 
bojces specified for the program. Parameter boxes indicate which files 
(data sets on the storage device) are to be used for input and output, 
and indicate which options, if any, are to be used in ejrecuting the program. 
The options are described in the chapters for each program. 

4.1 ♦ Program Control Cards 

Program c ontrol cards have the following format : * 

**PROGRAM (Parameter Box 1) (Parameter Box 2) comments. 

Two stars (**) appear in card columns (cc) one and two of all program 
control cards. The stars indicate to BEDRES that a program is to be called. 
Following the stars with no intervening spaces is the name of the program 
to be called. The name of the program replaces the word 'PROGRAM" In the 
example immediately above. It is not necessary to spell out the entire 
name; only the first four characters are absolutely necessary. 

Next come the parameter boxes-sets of left and right parentheses 
indicating the names of the data sets containing the data to be processed; 
the datasets on which the output is to be written; and the options, if any, 
to be used. The boxes are named sytrbolically to facilitate their use; in 
the INDEX routine, for example, the file containing the text datwet to 

*A specific example of such a card might be : 

**EDIT(INPUr:TEXT,C0L:l-72) ( 0UTPUT : DATE, C0L: 1-72, 72) (CHANGE :*,C0L:1. 
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be analyzed is specified as: 

(TEXT: DD name, C0L: i - j) 
**TEXT*' is the symbolic name of the box and the colon separates it from the 
rest of the information in the box* *'DD name" would be replaced by the 
label of the file containing the text, and "COL: i - j" would indicate 
how many columns are to be read on the data set containing the text. 
**Col: i - j*' can be interpreted as "the text is found in columns i throu^ 
j/' The letters *'i" and "j" would, of course, be replaced by column 
numbers in an actual program run* 

The parameter boxes for any given program do not have to appear 
in the order specified in the discussion of the programs in the fol- 
lowing chapters. However, the order of the entries xd.thin each box 
MUST be as specified as shown. 

The word "comments" following the last parameter box can be re- 
placed by the user with information he would want printed out at the 
top of the program run. Note that the comments cannot include paren- 
theses or periods (or they will be mistaken for parameter boxes). The 
period at the end of the program card is taken by BEDRES to indicate the 
end of the program card. 

Program cards can extend over several cards though the total 
number uf characters within the boxes, including blanks, cannot exceed 
256. If multiple cards are used, a iy the first program card for each 
program can have the two stars in columns 1 and 2, and card columns 1 and 
2 of continuing program cards can be used for any characters other than 
asterisks. 
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A. 2. Multiple Program Execution 

BEDRES can excute multiple programs sequentially* job steps can 
be stacked. For Instance, a single run on the computer can execute a 
LISTER, an : INDEX and a CONCORDANCE. The only requirement Is that 
each program be called by Its own program control card and that each 
program have its own job step. 

A. 3. Input from Cards 

If the Input to a program Is from cards, the cards may be placed 
Immediately after the prgram card, and their presence reported to the 
program by coding a single asterlck (*) in the appropriate place in 
the parameter box for data for the program. For exanple: 

**C0NC0RD (REQUESTS:*) (...) (...). 
would evoke the C0NC0RD program and define the dataset called "RE- 
QUESTS" as being the cards following the program card. "REQUESTS'* 
in the parameter box is the box's symbolic name. The first card fol- 
lowing the dataset on cards should have "E0F" in cc 1 - 3. This card 
indicates the end of a dataset on cards. 

Another way to use cards as input is to indicate a symbolic name 
for the cards in the appropriate parameter box and then define the 
dataset as being on cards using the IBM/ 360 Job Control Language con- 
vention. For example the program control card: 

**C0NC0RD (REQUESTS: REQUESTS) (...)(...). indicates to the 
BEDRES monitoring program that the requests for this Job step are 
to be found In the dataset labelled REQUESTS. Later in the same job 
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step the user should indicate: 

//REQUESTS DD * 

in Job Control Language* He should put the dataset on cards imne- 
dlately aft^r it and end it with /*. 

4. A. Error Messages 

BEDRES prints error messages when errors are detected in the 
specification of program cards or in the e)fficution of package programs. 
These errors all cause the execution to be terminated. The messages, 
and the remediaflon to be taken in each case, follow immediately. 

***ERR0R (BEDRES 1): N0 PR0GRA^^ CARD. 

BEDRES could not find a card with two stars in cc 1-2. The 
probable cause is oversight or the absence of a **E0F card terminating 
the data cards for the previous job. If <5ax4» had been uMd £or the pro 
gram. Correct the error and resubntit the Job. 

***ERR0R (BEDRES 2) : PR0GRAI'I N0T F0UKD. 

The program card called a nonexlttaat ptcgrss, or the first four 

characters of the program name were mlsspellecU Correct the card and 
resubmit the job. 

0NrffiRAfl^?^.^^' "'^^ '^^ CHARACTERS F^R 

This message indicates that too many boxes or too aany characters 
had been encountered for the program card. Check to make sure that 
boxes end with right parentheses and make sure the program card ends 
with a period. 

ra^us? prSi."^^' mcEssim st0pped because 0f err0r in 
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This message indicates that an error had occurred in the program 
just run and BEDRES was terminating the run. When this message is printed 
out, an error message from the preceding program will also have been 
printed. Correct the error in the preceding program and resubmit the Job, 

4.5 Completed Execution 

When BEDRES reaches the end of a job, it prints out: 
ALL PR0CESSING HAS BEEN C0MPLETED. 

4.6 INTERP 

Note that BEDRES does not examine the contents of parameter 

boxers; that task is delegated to IHTERP and the program called by the 

user. (See Figure s, P-37 ) Occasionally » a parameter box will not 

contain a colon (:) between the symbolic name and the information con* 

talned in the box. In this case, INTERP prints out the following message: 

***ERR0R (INTERP) : THERE IS N0 C0L0N AFTER THE KEY W0RD IN THE 
PARAMETER B0X. 

In this ca«e, the default option (see glossary) io. that box Is 
used* The erro^ being considered can be corrected by placing a colon 
after the symbolic name in the appropriate parameter box. 

4.7 Input /0utput Routines 

The input /output (1/0) routines are of no consequence to the ordi- 
nary user; with the exception of reading the input and printing the out- 
put, the user should see no indication of their functioning. 

The following programs are Included in the input /output routines: 
READ, WRITE, F0RMAT, GETEDIT, L00KAT, PUTEDIT, FIXEDIN-REALIN, nXED0UT- 
REAL0OT, AND CL0SE. (See Figure 5,^ p. 37 ) DATE is also Included 
^ with these routines though it does not function directly in input/output • 
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4.8 Job Preparation 

Preparation of a job is no more than the proper preparation and 
ordering of cards to input to the computer. It is assumed that the programs 
needed by the user have been keypunched and assembled and that a load module 
resides in the system (See Figure 3), The purpose of the rest of this 
chapter is to ccqt^rJ.r.t tie ujc^r with the essential nodules of instruction 
that arc riiquiretl for the liEDREJ programs. 

4.9 The /* ID card 

An ID card contains billing information and information regarding 
the requirements of the job, e.g. an overestimate of the number of Input- 
Output requests to be used, and an overestimate of the amount of time re- 
quired to process the data. 
For example, the ID card: 

/*ID PS»555,CODE='^aKE,NA^E»SMITH,DEPT«ED,LINES=15OOO,I0REQ«5OOO,TI^lE«2 
indicates the follw^ing information. 

The user's PS (problem specification) number is 5555. The charges 
for this job will be deducted from the account numbered 5555. The PS num*- 
ber is code-word protected, that is if someone were to try and use this 
PS# without specifying MIKE, the job would not run. The character string 
laKE is replaced by XXXX on the print-out the user receives from the com- 
puter so that the print ccn be discarded without fear that some other user 
could retrieve it and run a job on PS//5555 if he didn't know the code word. 
A flow chart which specifies each of the parameters found on the ID card 
follows: 
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FIGURE 6 - ID CARD PREPARATION 
ID Card 
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PR0BLEM SPECIFICATION 
NUMBER 



/*ID 
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/*ID must appear in columns 1-A. 



One or more blanks. 



ps// 



^ ps// is the user's four^dipit 
/ Problem Specification Number 



DEPAPvT?OT 



i ,DEPT= 



1 
I 



/ 
\ 



dent. 



/ 



dept is the department code 
associ?^ted with the ps<f» 
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t 
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^ nane j 



C0DEI'J?RD 




name is the user's name of 1 to 18 
characters, includln<» apostrophes if 
used. If name contains any characters 
other than A-Z and 0-9, then it must 
be enclosed in apostrophes; e.p., 
NA^f]-='J0NES J0HN'. If an apostrophe 
is part of the name, it must be coded 
as t\io consecutive apostronhes: e.p., 
'H.0' 'HARA'. 



The user also has the option of having* 
a code v7ord assigned to his ps//. 



code the code word associated with 
the ps/-. 
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FIGURE 6 - Continued 



(min,sec] 
K»sec) 
nin 



Do you x^ish to override the default 
tine estimate of one minute of 
CPU tine? 



Min and sec must be integer constants* 




LIVES 0PTI0N 



Do you \d.sh to override the default 
estimate for printed lines of output 
which is 2000? 



V 




XXXX Lines may be printed; the D 
indicates that a dump is to be attempted 
if this limit is exceeded, and that the 
limit is to be ignored during printing 
of any Abend durrp output. 
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FIGURE 6 - Conilnued 
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CARDS 0?TUr 



Do you vjlsh to have cards punched? 
The default is zero* 



/ ; xxxx \ 
/ )(xxxx) ^ 
: (XXXX, 




xxxx is the number of cards that may 
be punched; the D specifies that a 
dump is to be attempted if this 
limit is exceeded. 



I5iREQ 0PTI9iM 



Do you vlsh to override the default 
of 1000 INPUT/OUTPUT requests? 



Here, n is the number of INPUT /0UTPUT 
requests. The prop.ram will Abend 
if this limit is exceeded. 



End of the ID card for the BEDRES 
packaf>e. 
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4tl0 The SETUP card 

This card notifies the machine operator that the device mentioned 
should be mounted for the successful completion of the job. In our case 
the SETUP card: 

/ASETUP UNIT-DISK, ID-EK0023 
causes the disk numbered DK0023 to be mounted and accessed for the execu- 
tion of the Job. It will be remembered that for our project the program 
load Modules and the datasets that contain the field notes are all on the 
disk DK0023. The appearance of a /*SETUP card caustis a job to be placed 
iu a setup hold, and the setup information is written to the operator's 
console. When the operator has mounted all disks or tapes requested, 
the job is then released for ejojcution. A flow chart indlcatlAg tha pawmater 
of the SETUP card follows; 
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FIGURE 7 - SETUP CAIUJ PREPARiMION 
5.13.3. /*SETUP Card 



A9 



Format : 



/*SETUP lINIT=clevice,ID=(Ser/-', options) 



( START ^ 



4 



11 



/*SF.TUP 



K ^ 



0 



One or more blanks. 



UNIT= 




Device choices: 

2314 - 2314 disk 
TAPE - 9 track - 1600 BPI tape 
TAPE8 - 9 track - 800 BPI tape 
TAPE? - 7 track tape 
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f 

/ 



serf} 



J 




YES 




Is the device a 
magnetic tape? 



Ext€>rnal label of the tane or \ 
disk to be r^ounted. \^ 



1 ibel options 



■ SL ^. 



Specifics V7hether the tape is 
labeled internally with tlie above 
ser/- (SL) or not labeled internally 
(NL). (SL is the default.) 



' RING ( 

protection options < N0RINgJ 

Specifies that the tape is to be 
written on (RING) or that it is to 
be protected from bein^ written 
(N0RING). (RING is the default.) 
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A. 11 The // EXEC card 

t 

This card serves to begin a job step and to indicate to the operating 
system that a program which is a member of the load module called BEDRES 
is to be executed. It also contains code words for special requirements 
of each BEDRES program. These are specified in the sections dealing with 
specific programs such as INDEX or LISTER. 

// EXEC PGH='BEDRES, WORDNAiM=Blue, SENTNAM=Yellow 

The user should remember that the EXEC card also signals the begin- 
ning of a different job step. For the BEDRES package usage it has been 
useful to put each separate program in its own job step. If, for example, 
the user wants to get a list of the contents of a dataset with field notes 
in it and an alphabetical list of the different words in the dataset he 
would write a '^ram with two or more job steps. The first step might be 
called a * LISTER'' step since he would call the LISTER program first. The 
second step could be called an 'INDEX'* step in the users mind since that 
step could call INDEX into execution. In BEDRES jargon then the user can 
create C0?Y, EDIT, LISTER, INDEX and C0NC0RD steps in any legal sequence 
that he desires. A word of caution, however, the IBM 360/75 systems 
cannot handle jobs with a ridiculously high number of steps. As a rule 
of thumb the user should limit his jobs to around 10 steps and fewer. 

4.12 The // C0mR0h CARD 

This card precedes the program control card (See section 4.1), for 
each BEDRES program. The card: 
// C0NTR0L DD * 

has only one entry, a star at least one space away from DD. The star 
indicates that the program control cards follow immediately. The first 
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card following the control card has to be a program control card. The user 
may put as many legal program control cards after the INPUT card as he 
desires. Emphasis is placed on "legal program control cards." There 
are two ways of defining legal at this point. First, it can be taken 
to mean proper keypunching. If the program control cards are mispunched 
either by pressing a key to punch a (.) instead of a (,); or if a package 
convention is violated in keypunching a card, then that card is illegal. 
Second, if a program control card calls a program that accesses an ille- 
gal file, the program card is not legal. 

One of the hidden gremlins in the 360 operating systems is that the 
programs executing in a given job step can either read existing datafiets 
or create datasets. It is not possible to create a dataset say WORDLIST 
with LISTER in a job step and expect that INDEX can read WORDLIST In the 
same lob step. The remedy for this situation is to put a separate LISTER 
step and later a separate INDEX step in the job deck. 

4,13 Program Control Cards — **Cards 

The program control cards are instructions to the BEDRES programs. 
The card: 

**EDIT(INPUT:TEXT,C0L:l-72) (0UTPUT ;D ATE, C0Lr 1-72,72) (CHANGE :*,C0L:1 80). 
calls the program EDIT to perform some operation. In the case of the card 
shown here the EDIT program is to perform its operation on the dataset defined 
as TEXT. Once the operations are finished the results are to be stored 
the dataset defined as DATE. The specific changes to be performed are 
punched on cards that follow the **EDIT control card since a * is punched 
after CHANGE. 
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The card: , 
DELETE 86 T0 1229 • 

defines the specific operations for EDIT to perforti!. In this example the 
user has indicated that EDIT should take the dataset with a DD name of 
TEXT in this step as input. EDIT was then directed to delete sentences 
number 86 through 1229 and put the remaining portion, sentences 1 through 
85 on the output dataset with the DD name DATE. 

The user should look back at the last parameter box on the **EDIT 
program control card. That parameter box is as follows: 

(CHANGE :*,C0L: 1-80) . 
The - after the x/ord change indicates that the specific change instructions 
are on cards that begin immediately after the **EDIT card. IVhen the user 
wants to put the changes on cards and include them in the INPUT file (de- 
fined as all of the cards between // cards DD * and /*) he should put a * 
after the change. The user should remember that at the end of the file on 
cards in INPUT there has to be a card that is coded. 

**E0F 

There is another way to tell the computer where to look for files on 
cards. We could have put: 

( CHANGE : ALTER , C0L : 1- 80 ) , 
in the last parameter box in the example. That string of characters would 
instruct the BEDRES program to use the contents of the file X7ith the DD 
name ALTER for instructions on the chan[>es to be made. If this option is 
used and no other cards are put in the INPUT file then the user must define 
the file ALTER in the following way: 

//ALTER DD * 

(changes to be made) 

/*. 



The module of cards defining ALTER can go anywhere in the job step that 
it pertains to. 

In the beginning the user will probably prefer to use the latter 
convention since it helps him to separate each of the datasets that need 
to be defined for execution into distinct modules of cards. Either of 
the two options work equally x^ell, however, 

4.14 The card 

The card: 
I* 

must be put after the last card of any dataset that is on cards for the 
job step. Since // cards is a dataset that Is generally on cards, a /* 
must be put at the end of the cards dataset. The larger files, such as 
datasets of field notes or word lists usually are on the disk pack. 
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5. L0AD EDIT 

• 

Although the BEDRES package contains a single program called EDIT, 
we single out one very important operation of that program, which is called 
L0AD EDIT for emphasis. 'X0AD EDIT*' is simply a special form of the EDIT 
program which enables the user to 'load" data-punched on cards onto the disk 
in order to facilitate handling. It must be noted, however, that this is 
the most critical step in the entire BEDPES operation, since (1) the data 
are labeled for future reference at this time and (2) unique codewords are 
assigned to each dataset to insure that operations performed on any of the 
data do not interfere with the status of other data on the disk. 

5 .1. P rocedure for ex ecuting L0AD EDIT 

The following cards must be prepared for L0AD EDIT: 

// EXEC BEDRES, TEXT=' (textname) ' ,TEXTDSP=' (NEW, KEEP) ' 
// SETDISP=' (NE17,KEEP) ' ,W0RDriAr:=' (wordname) ' , 
// SENTNAM«' (sentname) ' ,REGI0N=1OOK 
//C0NTR0L DD* 

* *EDI T ( INPUT : CARD , C0L : 1- 80 ) ( 0UTPUT : T E XT , C0L : 1- 80 , 80 ) 

(CHA1JGE:*,C0L:1-8O) . 

NONE. 

/* 

//CARDS DD * 

(Data ^cGk; i.e. data cards, follow at this positioni 

E0F 
/* 

The parameter box labeled (textname) indicates the name of the 
dataset to be entered onto the disk. This name is the same as the 
filename of the dataset ^ v/hich consists of an eight character speci- 
fication of the user, the date, and the tvpe of data (See section 2.2.) 
, The parameter boxes labelediwdrdname) and (sentname) are to be 

completed by using any word of seven characters or less in these boxes. 

I 
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Each box must have a different word, however, and each new dataset will 

have its own unique oodawords. To insure that the user does not misplace 

or lose track of which codewords apply to each dataset, it is wise to 

punch an e::tra card cc^.taining the code^rords for the dataset and insert 

this card into the deck iimicilatcly after the filename. The example below 

will illustrate how this can be done. 

5. 2 .Sample L0AD EDIT Program 

/*ID PS«A545,NAI«1E= BURNETT, C«!DE«ANTHR«J 
/*SETUP UNIT»DISK,ID«DK0023 

// EXEC BEDRES ,TEXT« ' JB01049II' ,TEXTDST» ' (NEW.KEEP) * , 

// SETDISP* ' (NEU,KEEP) ' ,W0RDISP= ' (NEH,KEEP) * ,W0RDNA^t• , 

/ / SENTNAM=» ' BLUE * , REGIC^N'^- iCOK 
//C^NTRJiJL DD * 

**EDIT(IN?UT:CARD,CeJL:l-80) («)UTPUT:TEXT,CtfL: 1-80,80) 

(CHANGE :*,C0L: 1-80). 

NONE. 

/* 

//CARDS DD ^ 
JR010A9II 

^:ORDNA^?«*YELL0W* ,SENTNAII»*BLUE' 

[Now place rest of data deck here] 

E0F 
/* 

This sample progrnn specifies that the dataset labeled ^JB01049M' 
is to be loaded cnto the dinky and that the codewords ^ YELLOW^ and 
'BLUE* v;ili be imiqu^. uo tihlo dataset for all future analysis on the 
computer.^ Note that tho first two cards in the data deck are (1) the 
filename of the dataset ( 'JB01049M* ) and (2) the special codeLi)ord8 
for this dataset. 



In each example which follows, the codewords YELLOW and BLUE are assigned 
to the dataset JB01049M. Individual users may apply any codeijords they 
wish to datarets, as long as they are less than seven characters in 
length. Sec section 6.1.1* 
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6. EDIT 

EDIT can be used to perform several other tasks. First, it can 

be asod to move data from one record length (number of columns or 
characters per record) to another. For instance, it may be desirable 
to atore data at 120 columns per record on a disk uhile the data has 
been kejrpunched at only 72 dolumns per record. The movement can also 
be from longer to shorter lengths* EDIT can be used to separate por-» 
tions of data from other portions. For instance, reports of contact 
with three different informants may have been included on the same file, 
vhile the account from the middle informant may be the only one of in- ' 
terest. The account of what took place with the second informant can be 
separated from the other two through the use of EDIT* The third and 
last t4tk that can be performed is the changing of individual words or 
sentences in a file. For example, data which were keypunched can be as- 
sumed to contain typographical errors. These errors can be corrected 
using the EDIT routine. In use» however, we have found the EDIT routine to 
be very cumbersome for doing very extensive copy editing. Instead, we 
new obtain a printout of our ke3rpunched data cards and do the initial 
copy editing and correcting from that printout. Further development of- 
the editor will be necessary before we can recommend its use for copy 
editing the texts on the computer, in addition to its other uses. 

6,1. Procedure for Executing EDIT 

EDIT is called by the following program card: 
**EDIT(INPUT:inname, inf ormat) (^)UTPUT:outname, outformat, 
length) (CHANGE: chanamc, chaformat). 
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The INPUT box contains two en tries— the input filename (replac- 
ing inname)^ and the format for reading input file records. The 
input format replaces in tl»e parameter box. In a similar 

manner, the name and format are specified for the edit'id material 
(in the 0UTPUT bo::) and the file ' .1 which the changes to the input 
file are to be found (the CHANGE box) . Lc^^h in the CUTPUT box 
indicates the number of character3 output per line. 

6.'2. Default Options for EPTT 

Default options exist for the formats and the CHANGE file. 
Unless otherwise specified by the user, the three formats read or 
write only the first 72 columns of each record. The CHANCE file 
default name is INPUT and assumes that the changes follow Inanediately 
after the program card. There are no other default DD names* The 
default length in the 0UfPUT box is 72. 

6.3. Using EDIT 

EDIT can be used to concatenate small pieces of files on one 
large file. The concatenation procedure is useful for reordering 
field notes in different ways depending on how the researcher wantB 
to view his d"':^. 

Operational];/, to co.icateaac*2 , EDIT is used to lift out a small 
piece of the corpus md r.> c :oro it at the end of the file that the 
user is building. The user should be oDore of the fact that separate 
30b steps are needed fov each piece of aovpuz that ia to he added to 
the large file. Also, a single Job submitted to the computer should 
hove no more than 10 Qob steps. Otherwise, the machine will wait for 
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a long time until enough core is available and the job may terminate 
because the program was in the waiting state for too long a period 
of time, usually 8 minutes or longer. 

If the user puts the follo\-7ing program cards in the deck for EDIT: 

//C«!NTRgJL DD ^ 

**EDIT ( INPUT : JB01049M , C0L : 1-80) (OUTPUT ; SCRATCH ,C«)L : 1- 80 , 80) 

(CHANGE:*, C0L: 1-80). 

DELETE 1 T0 j. 

E0F 

/* 

he is instructing BEDRES to scan the dataset called INPUT for all control 
instructions. Note the after the word CHMGE in the last parameter box 
which, in BEDRES, means that the change instructions follow immediately 
on the cards. 

If EDIT is to be used to make substantive changes to a file, 
it is necessary to know the number of each sentence to be changed. These 
numbers can be computed by hand, but that task can be done more easily 
by LISTER. If the LISTING option for LISTEF is coded YES y a listing of 
the text will be produced with sentence numbers indicated. 

6.4 Changes 

Four types of changes, DELETE, ADD, II0DIFY, and N0NE, are possible 
using EDIT. 

DELETE causes whole sentences to be dropped from a file. It is 
specified by: 
DELETE i. 
DELETE i T(3) j. 
or DEIJ2TE i, j. 
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The first oxaupie would cause sentence number i to be deleted while the 
second and third examples v;ould cause sentences i through j inclusive 
to be dropped. The last tv;o exapmles might be used to lift a Riven 
portion out of a file. For instance, assume tha: a user wished to 
generate an index on sentencer 376 through 458 of a corpus which was 
1375 sentences long. After specifying the 0UTFIJT file in the appropriate 
box on the program card, he would indicate tv;o deletions: 

DELETE 1 T«5 375. 

DELETE 459 1375. 
After the deletions were executed, the 0UTPUT file v;ould contain sentences 
to be inserted into the corpus. This type of change has the following 
format: 

ADD BEF0RE i sentence 

ADD AFTER i *' sentence 
In the first example, the sentcnce(s) within the quotation marks (** 
and '*) would be inserted into the 0LITPUT file inanediately before sentence 
1. In the second exir:pje, the sentence would be inserted immediately 
after sentence 1.. Note that the quotation marks mus t be surrounded by 
blanks to assure thrt the apostrophes arc not taken to be part of the 
sentence being inseito.d. 

1!C!DIFY, allows strings; of characters within sentences to be added 
or deleted. Note tha- the jtrings nay be vTords, numbers, or punctuation 
marks. The format for thlr. tyc-o of change ds: 

V4DIPY i CHANGF, ^' en bb T0 aa cc 

M0DIFY i REPLACE aa bb !'ITH aa cc 
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Ir both cx-^nplr?, uIk. vn-.n^ // in s<nt*nco rould he rcplrccd by the 
\'-)rci r-c*. Nott tii^t cv^r tlioufh tlu- v^^rJ 7(? is deleted .-^nd then r-ddcd 
-^g.^in (nsultinp in n' ch'^nf'e) it servi^s n useful function, n.-»mcly 
'^s .'>n indication cf whrru in sent«."nco "i" the podific^tion is to tP.kc 
pl^ci.. Usinp; such .-^n iViCficr \WV(^ is Irport.-^nt in c.'>scs v;hcrc the \'ord to 
be dv'li'ted :^r>V''y rrs n,.rc ihnn rncc in iIk s. ntcnc^ . If >'0 'TKchor ^jovd 
i'^ 'ji}od ir: riic*' 'irryrc^ tJ c fir.Jt nryv^'iorcn'^r- of i],r \^orr^ in qupc.tion Dill 
})(: noc'ifi.rd. 

N<»te th'-t \:i^rd?^ C^n h.^ di letvd fr'M> ^ent^ nccs by specifying 

M0DTFV i T^^.Pl.yNCK rr bb^^^^^MT rr 

MtolT-^ i RKPLACr. ' bb V^v niTi; r r ' . 
In the first ox-^npic r>n .-^ncl^r wor<1 is usid, while the anchor word is 
eliminr'tcd in the second. 

^^^rds c^n bo /'•ddec! tr srpt(nces thr^u^^^ the use of 

^l0Dirv i KFPL/'CI- -r ' > ^»IT1| bb ' . 

Use of thu "^t/DTPi* change; i\i this ^ .-nner e-usos the- word bb to be 
inserted in scntcncv^ f '"I't.'r t^^^. ^'on^ 

Scvur.-^l ^^C^nr^' ch.-n^vs c-n !v t^^ thv' spre sentence using the 

word f'-0Diry ' nlv - vc. ii the ter-'imj '.-^erioc! is replaced by a cor.pa 
r'nd thu //VZ/tc : . . . . . . nortim i^; r..'nept< d. iJic last character 

in tnc choice '\JCt ^J>-'^ . 

In mnkinr oh.:^n{^s, tht usi-r should -^cert; in that the sentences 
beinp. chpnr.od nn, snccifird in .-^sccndinr ord(^r. (See error aoss^^'pe 
Kbil /ttenntinj^ ch.-noc • s^nttnc*. thr>t has already been ppssed 

throup.b tile cor^puter v;111 result in .'*n error. 

Specifying' the ch.-^npi V;^/; " -s ^ rh.ni^o vn'll cause the entire file 
to be ppssed throuph unchrnfed. This ch.-^njrc vrould be used in the event 
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a user simply wished to nove the data on a file from one line lenpth 
to another. For instance, data which x^as punched in the first 72 
columns of a card can be moved to 120 characters per line (e.g.» on a 
disk or tape) through the use of the change Refer to the Example 

section under L0AD EDIT to see ho\a this is done. 

In the event that the sentence number is not specified » an error 
(^^ERR0R (EDIT S) ox ILLEGAL CHARACTER IN INPUT RFJC0RD) vrill occur. 
See the *'^'^ERR0R (EDIT S) write-up in the follwing section for the 
appropriate remediation. 
6. 5^ Error tIessaRes for EDIT 

***ERR0R (EDIT 1): 

THE OUTPUT LINE LENGTH AI4D P65RIIAT HAVE BEEN INCORRECTLY 
SPECIFIED- 

This error message indicates that the last two entries in the 
0UTPUT box have been incorrectly specified. Correct the error and 
resubmit the job. 

***ERR0R (EDIT 2): 

THERE IS NOT ENOUGH C0RE AVAILABLE F0R THE DATASTAK* SEF THE 
PROGRAI^ ^'PITE-UP. 

This error occurs when insufficient core (memory) is available to 
execute EDIT* This difficulty can be overcome by requesting more core 
(on computers usin? IIFT or IIVT). In other caacs, see a consultant at 
the computer installation. 

***ERR0R (EDIT 3): 

THERE IS N0T ENOUGH C0RE y^VAI^JVBLE F0R THE CllNGSTAK. SEE THE 
PR0GRAI1 \JRITE-UP. 

See ***ERR0R (EDIT 2) above. 
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***ERR«jR (EDIT 4): 

THE aiANGE T)0ES N(>T BEGIN ^'ITV "ADD*', "DELETE", 0R M0DIFY". 

As EDIT changes a file, it prints out each change specified by 
the user as that change is acted upon by the program. !Tien this message 
appears, the change printed out immediately above it will be foimd to 
begin with an illegal uord. Note that in specifying changes, only the 
first three characters of the key uord need be specified* Thus DELETE 
and M0DIFY changes can be executed using DEL and H/D* This error message 
may have occurred because the first three letters of the key x7ord had 
been misspelled. 

***ERR0R (EDIT 5): 

N0 SENTENCE IIUIIEER HAS BEEN SPECIFIED F0F THIS CHANGE, 
This error occurs vjhen the user has failed to indicate the number 
of the sentence to uhich the change refers. Indicate the sentence 
number and resubmit the job. Occasionally, this message will not appear 
and the message INVALID CHARACTEP IN INPUT STRING will appear. 
Remediation is the same as specified above in ^**ERR0Ii (EDIT 4). 
***ERR0R (EDIT 6): 

THE CHANGE SPECIFIED D0ES N0T END; THERE IS 110 PEPI0D, 
QUEST I ^ MARK, 0R EXCLAIiATION P0INT. 

This message indicates that the change printed immediately above 
it on the print-out does not have a terminal punctuation mark. Insert 
a period, question mark, or exclamation point at the end of the change 
and resubmit the job. 

***ERR0R (EDIT 7): 

THE CHANGE D0ES N0T INDICATE THE LAST SENTENCE T0 BE DELETED. 
This message appears when a DELETE change, dropping more than 
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one sentence does not specify which sentence is the last to be dropped. 
Indicate the last sentence nunber and resubmit the job, 
***EFR0R (EDIT 8): 

THEPE IS N0 INDICATION 0F tiKETHER THE ADDITION PRECEDES 0F 
F0LL0WS THE SENTENCE INDICATED. 

In an ADD changG, on errcr occurs if the words BEF0FE or 
AFTER do not appear. This error causes the imnediately preceding 
meesage to be printed out. 

***ERR0R (EDIT 9) : 

THERE IS W0 SENTENCE NUltBE?. INDICATING IHERE IN THE C0PPUS THE 
ADDITI0:^ IS T0 BE TiADE. 

The ADD change printed iirunediately above this messape in the 
printout does not contain a sentence number. Indicate the number and 
resubmit the job. 

***ERR0R (EDIT 10): 

THERE IS N0 0PSNIWG QU0TATI0N TAFK F0R EITHER THE INSEPTI0N 
0R THE DELETION. 

If the words to be inserted or deleted in a 1I0DIFY change are 
not preceded by a surrounded by blanks, this message will be printed 
out. Insert the opening quotation marks and resubmit the job. 

***ERR0R (EDIT 11): 

THERE IS N0 INDICATION 0F WAT IS T0 BE PEPLACED. 
In a r0DIFY changa, nothi ig wns found within the quotation marks 
following CHAIGE or REPLACE. Correct the error and resubmit the job, 
***EPR0n v'KDIT '2): 

THE P0RTI^:iN T^^* REPLACED CANN^/f ?E F0JKD. 
The xijord or -.'orcb to dc droj^jed from the sentence specified 
in a i:0DIFY change canno" be found in the sentence indicated in the 



70 



65 

chantiL. This ..-rror n<»v l^vu occurred h^cnusc the sentence number was 
incorrectly specified or the portion to be deleted wps incorrectly 
indicated. Correct the error and resubmit the job. 

^^^'^^ERRi^R (EDIT 13): 

THE P0RTI0N T0 BK INSEPTFD C;U]N0T RE ¥0WD. 

In o ;!0DirY change, failure to indicate at least one entry 
between the insertion quotation marks will cnus^ this error message 
Fdit i:-> to be Printed. Correct the error and resubrit the job., 

^'-'^'•*-EHR0P (EDIT L4) • 

N0 END 5ip C0MTINIJATI0N 'VS EMC^UNTCPED. 

No te-nrinal punctuation m-^rl- or comna indic^tinp additional 
modifications t^as found in the V(fDlW chanpc listed above this 
message in the v>rintout. Correct the error and resubmit the job. 

'^'**ERP0R (EDIT 15) • 

niNT.STAK (fi\rL?^Wy: DIVIDE THE CW/^NHE IMT0 S^'ALLER P(?PTIONS. 
This PessaRo -^ppe-^rs wb.en the user h.-^s indicated a change that 
is very lonf* . Divjdv. th., chanr'e into spallor changes and resubmit the job. 

'•^^*EPP0P (EDIT 16) f 

THIS SENTENCE HAS ALRE/DV nEEI PASSED THR0UGH EDIT. 

This mcsS'-^pe -appears x/hen the sentence number specified In n 
chnnpe refers to ^ sentence whose number is lower than the one currently 
in th., computer. Either the chanfre is out of order or the sentence 
number has been incorrectly specified. Correct the error and resubmit the 
1 oh 
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^<'*'**FPRC!R (rniT 17): 

Tin: DATA \\D/^M\ Output ftliis r^vii nv^i deen spf.cifii-d. 

This iPessPf^t pppcP.rs v;hon the user hps not specified the n.-^ne 
of the file to bo edited or the npDo of the file on v^hich the G<Htcd 
materirl is to be written, Indicp.te the np.ncs of the files in the , 
appropriate boxes on the proprai^^ cp.rd and resubmit the iob, 

6* 6 . Additional Message 

After certpin errors h-^ve occured, an .'^<3ditional message will be 
printed out: 

'-'^^NOTE: BECINNTNO VIJW TVIS CVniGi:, PURTHEP CHANGES 
I'ILL ?E ''ADE-; THE PE^V.INDLF 0F THE C0RPUS WILL 
BE r 0DIFJED\ ' * 

This mossapv indicltfis that the current chr»npo contained rn error, ajid 

that no additional chanj^cs v^ill be nndc, 

6.7 . Proprans Necessary to Execute.. EDIT 

PEDPvES, the input/output routines, PTiiJ, AUXG'^EN, PETH, ond 
EDIT are reniilrt-d to execute I'.DTT, The irput/cutput routines arc^ 
listed pbove. 
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7. LISTER, 

97 

Two programs must be executed in order to generate an index « The 
first, LISTER, goes through the text to be indexed and produces a list 
of all the different words which appear and an indication of the number 
of times each word appears. INDEX, the second program, takes that list 
and determines in which sentence each word appears and indicates ^7 
mnbera the sentences in vhidi each of the different wo^rde appear. 

7.1. Semantic Units 

LISTER and INDEX have the additional capability of handling semantic 
units; i.e., groups of up to ten ecntirtuoue uorda with no intervening 
punctuation marks which have some meaning when taken together other than 
what could be expected from the meanings of the individual words* 
Examples of semantic units would include idiomatic expressions (e.g., 
UP TIGHT) and proper names (e.g., HOUSE OF DAVID). Semantic units are 
» assigned labels as they are encountered in the text by LISTER and the 

occurrence of each semantic unit is reported in the final alphabetised 
list of words and index, under "semantic unit." 

The first occurrence af a semantic unit must be epecified by the 
user through the use of the "less than" symbol (<) and the "greater than" 
symbol (>) as in: 

< UP TIGHT > 

The programs will then note that the specified words represent a semantic 
unit, assign it a label {SUOOl through SU999) and search the remainder of 
the text for occurrences of that semantic unit, uniy the first occur- 
rence of each semantic unit la a given dataseC should be bracketed. If 
more than 999 semantic units are encountered in a dataset LISTER will not 
perform properly. No more than 999 semantic units can be put in a dataset. 
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At the end of thu LISTER printout, all s<^nantic units and their 
labels will be written out: 
SEIiAiNTIC UWITS: 

SUGOl: UP TIGhT 

The alphabetized list of words output by INDEX X7ill contain the labels 
for each semantic unit, thu number of tiititis each appeared and the 
numbers of the sentences in whidi eacli appears. 

7.2. Conventions in LISTER and L^oLX 

LISTER and IWDEX utilize only one convention not specified in the 
chapter on BLDlUiS and the Input/Uutput routines, l^ords can have a maxi- 
mm length of 16 characters. Words longer than 16 characters are truncated. 

7.3. Procedure for Executing LISTER 

The follo\;inc cards raust be prepared for LISTER: 

// EXEC BEbia:,S , TEXT= ' ( textnaiut: ) ' ,\'I0l<L.iAi^.^ * (wordn^oiiie) ' 
// SEJTNAiiE=' (sentname) ' 

**LISTER (TEXT :TEXT , C0L : 1-80) (U'v^RDLIST : W0ia)LST) (LISTIi^G : decision) • 
/* 

The parameter box labelled (textname) indicates the dataset to be analyzed. 
The parameter boxed labelled (uordname) and (sentname) on the // EXEC 
card contain the codewcrds fcr that particular dataset. /is noted in the 
section concerning loading data onto the disk (see the COPY routines), 
each dataset has its own unique Codewords. For exar.ple, a // EXEC card 
set up in the following manner: 

// EXEC BEDRES, TEXT=' JB010A9:r ,W(^RDi4AII='YELL0W .SEUTNAH^'BLUE' 
specified the text as 'JB0l049i4' and indicates the codewords unique to 
that dataset, YELL0W and BLUE. 
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The LISTING box on the ^'^LISTER card is used to Indicate xjhether a 
listing {printout) of the data generated by LISTER is desired. This 
printout lists the data and indicates the sentence number associated with 
each line of the text. The word decision is replaced by YES if the 
printout is desired and 1^10 if it is not. 

7.3.1. Sample Program 

/*ID PS=4545 ,NAME=BURNETT ,C0DE=AI^THR0 
/*SETUP UNIT=DI SK , ID=DK0023 

// EXEC BEDRES, TEXT= ' JB01049I'r , W55RDNAJI='YELL0W' , 
// SENTNAM='BLUE' 
//C0NTR{SL DD * 

^*LISTER(TEXT:TEXT,C(^L:l-80) (WtoLIST :W0RDLST) (LISTING: YES) . 

This sample program runs LISTER on the dataset labelled JB01049M^ 
gives the appropriate codewords for this dataset, and asks that the data 
generated by LISTER be printed. 

7.4. Default Options for LISTER 

If the TEXT file name is not specified^ the text is assumed to come 
from cards immediately following the program card. The TEXT records are 
assumed to be in the first 72 columns of each recoid. Not specifying 
the U0RDLIST parameter box will cause the list of different xjords to be 
sent to the printer.: If no decision is indicated with regard to the 
listing of the data, no listing is produced. 

7.5. Error TlessaRes for LISTER 

Three error messages may be printed out by LISTER. 

***ERR(iR (LISTER 1): 
N0 C^^RE AVAILABLE. 
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This message indicates that there is no core available fo» the list 
of different words appearing in the text. If the program is being run 
under MFT or IIVT, request more core for the run. Otherwise, see a 
consultant at the computer installation. 
***ERR0R (LISTER 2) : 

N0T EN0UGH C0RE AVAILABLE T0 HANDLE THIS C0RPUS. 

This message indicates that the text to be handled is too big for 

the computer's memory. If the program is run under MFT or IIVT, request 

more core and resubmit the job. Othen/ise, break the text Into smaller 

segments and submit each individually. 

***ERR0R (LISTER 3): 
UNRECOGNIZABLE PARA^^ETER F0UND. 

This message indicates that the symbolic name for one of the parameter 

boxes was not ^lEXT", ''W^RDLIST", or ^'LISTING", or that the name was 

misspelled. Correct the error and resubmit the job. 

7.6. Routines Required to Run LISTER 

In BEDRES the input/output routines, OWEN and LISTER, must be 
included to execute LISTER. 
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8, INDEX 



8. !• Procedure for executing INDEX 

The following cards must be prepared for INDEX: 

// EXEC BEDRES, TEXT= ' (textnaine) ' ,W(?RDNM=' (wordnane) ' , 
// SENTNA14='(sentnanie)' 
//CjSNTRgiL DD * 

**INDEX(TEXT:TEXT,C«!L:1-80) (W<?kDLIST ;W0RDLST) (SENTLIST:SENTLST) 

(LISTING: decision), 

/* 

The parameter boxed labelled (textname)^ (wovdname)^ and (sentncme) 
on the // EXEC card arc handled in the same manner as they were in LISTER* 
Be sure that the codewords used are unique to the dataset to be analyzed. 
(See section on COPY routines.) 



If the index (list of words appearing in the text and the sentence 
nuinbers in which the words appear) is to be printed, the box symbolically 
labelled LISTING should be coded so that YES replaced decision. If no 
listing is desired, iW replaces decision in the box. 

8.I.I. Sample Program 

/*ID PS*4545 ,NA11E=BURI^ETT,C«5DE=Ai^THR0 
/*SETUP UNIT=DISK,ID«DK0023 

// EXEC BEDRES, TEXT='JB01049M' ,W«5RDNAII»= 'YELLOW* 
// SENTNAM='BLUE' 
//CONTROL DD * 

**INDEX(TEXT:TEXT,C0L:1-8O) (W0RDLIST:W0RDLST) (SEI^TLIST :SENTLST) 

(LISTINGiYES). 

/* 

This sample program runs INDEX on the dataset ^JB01049M^^ gives the 
codewords unique to this dataset (yellow and blue) and asks for the data 
produced by INDEX to be printed. 
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8.2 Default Options for INDEX 

The data are assumed to appear in the first 72 coliimns of each 
TEXT record. Unless othen^ise specified, the index produced will not 
be printed. Unless othen^ise specified^ the list of sentence numbers 
will be written out on a dummy file, i.e., a non-existant file» 

8.3 Cautionary Note 

Since INDEX utilizes the output frcm LISTER the text operated 
on by both programs must he identical. For example, if a file has been 
LISTERed and then EDlTed^ viust be reLISTERed before the index can be 
completed. 

If INDEX is not presented with the identical text as that which 
was used by LISTER to produce the FOJRDLIST required by INDEX, an error 
C***ERR0R (INDEX 1), ***ERR0R (INDEX 2), ***EPil«JR (INDEX A), or ***ERF0R 
(INDEX 5)] will occur. 

8.4. Error tlessaf^es for INDEX 
***ERR0R (rT^'' '')• 

W0RD IN THE LIST «)F DIFFERENT T^j!??^ . 

This message indicates that some v7ord was encountered by INDEX 
but was not in the list of different words produced by LISTER. The pro- 
bable cause of this error is the incorrect specification of the TEXT file. 
Correctly specify the file and resubmit the job. 

***ERFOR (INDEX 4): 

THE T0TAL FREQUENCIES OF THE DIFFERENT K«}RDS IS N^T THE SAl^ 
AS LISTER F«)UND. 

LISTER and INDEX both compute the total number of words in the 
text being examined. If the total arrived at by INDEX is not the same as 
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the total reached by LISTER, the above message is printed out. The source 
of the error is probably the same as indicated for ^^^ERE0B (LISTER 1). 
See that error above for the proper remediation, 
***ERROR (INDEX 5): 

DID N0T FIND THE SAIIE NUMBER (jJF SENTENCES AS LISTER. 

LISTER and INDEX both compute the total number of sentences 
in the text, and INDEX checks these totals to ascertain that they are 
the same. If they are not, the above message appears on the printout 
and execution terminates. For the sources of the error and the «Pf»ro» 
priate remediation, see ^^^ERR0R (INDEX 1), 

***ERROR (INDEX 6): 

THE TEXT FILE HAS N0T BEEI>I SPECIFIED. 

This messape indicates that no file name appeired in the 
parameter box symbolically named TEXT. Indicate the TEXT file name 
and resubmit the job. 

fliiliL J^outines Required to Execute INDEX 

In EKDRES the Input/Output routines, G\m. and INDEX, must be 
included in order to execute INDEX. The Input/Outjmt. routines 4xe 
listed above. (Sec .Chapter 4.) 
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The execution of the coriCordance program, C0NC0RD, for a given 
text requires that that text first have had an INDEX generated for it 
and stored for access. The generation of the index mu3t be done by 
LISTER and INDEX and the output from these programs must be stored on 
some device, e.g., a tape or disk, to which C0NC0RD has access. Under 
certain circumstances, ^uch a: whoii the text to be processed is small 
or a permanent storr.ge device ij not available to the user, the index 
and concordance are all performed :.n one run. 

9.1. Conventions used by C0iiC0RD 

As is the case in producing an index, C0UC0Wi) defines words 
as being 16 characters or leas in length. Longer words are truncated 
to 16 characters. 

9.2. Procedure for Executing C0NC0RD 

The following cards mu3t be prepared for C0NO(j)RD: 

// EXEC BEnRES,TEXT=' (textname)', Wg(EDUAM=' (wordname) \ 
// SENTNAM-'' (sentncims) ' 

//afim^L DD * 

**C0NC5!RD(TEXT:'i:EXT,C0L:l-8O) (W(?RDLIST:W^RDLST) (SENTLIST:SENTLST) 
(OnTPUT:PRirj,o;'L:2--C0,79) (LENGTH: pre, foil) (REQUEST:*). 

REQUEST C'^'JDCS J -PLACED HER/* 

/'< 

The parameter bo>:c:s :.rA>ri:-ri ( tet^tncone ) , (wordnme) and (eentname) on 
the // EXEC card are han'iled in the o.^nie manner as in LISTER and INDEX. 
Again, be sure that the codewords used are unique to the dataset to be 
analyzed. 
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The parameter box labelled LENGTH on the program control card refers 
to the number of sentences proceeding and following the sentences lo- • 
cated in the concordance which are to be printed out as well. The 
number proceeding replaces "pre" in the box, and the number following 
replaces "foil". 

Wote the position of the request cards for C45UC^)RD in the sequence above. 
These cards (described in section 9.4.) follow the program control card. 

9.2.1. Sample Program 

/*ID PS«4545 iJAIIE=BURI>IETT,C«5DE«Ai>ITllR0 
/*SETUP UWIT=DISK,ID«DK0023 

// EXEC BEDRES, TEXT=' JB01049H' , i:<8RDWAII«= 'YELLOW . 
// SENTNA1I='BLUE' 
//Cammt DD * 

**Cg)NC«5RD (TEXT: TEXT, COL: 1-80) (W9RDLIST:W«JRDLST) (SEWTLIST:SENTLST) 
(OUTPUT:PRINT,C0L:2"8O,79) (LENGTH: 6, 6) (REQUEST:*). 
REQUEST :L«JCATE ALL SENTEiNCES WITH THE \<9m ABLE. 
/* 

This sample program runs C0liC0RD on the dataset labelled •JB01049M', 
gives the approprJ \tc codewords for that dataset, and asks that six 
sentences preceding and six sentences following each concordance be 
printed. For this particular example, all sentences containing the word 
ABLE will be used in the concordance. It is possible, and indeed 
desirable, to use more than one REQUEST card in each job run. 

9.3. Default Options for Ct(NC<?RD 

If the REQUEST file name is not specified, requestc arc- assumed 
to come from cards immediately following the program card. If the OUTPUT 
parameter box is a' ft out, all output is sent to the printer. The 
dafault format prints the output in columns 6 through 125 of each line. 
The number of characters in each line defaults to 120. If LENGTH is 
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not specified » no sentences preceding or following the target sentence 
are printed. 

9.4. Requests to CgNC0RD 

Through the use of the filename specified in the REQUE:>T box, 
the user indicates to C0NC0RD whei.e the words and Phrases arc that are 
to be "concordanced . " These words and phrases take the form of l ogical 
requests — words bearing a relationship to one another that can be 
described in terms of the Boolean operators '"and", "or", and "not". To 
the user, the logical requests take the form of simple declarative 
sentences which are then compiled into Boolean form by PATH, the PATTem 
Interpreting routine. The Boolean form of the request is then printed 
out (so the user can ascertain that his logic was properly interpreted) 
and passed on to DIAilA, which Directly ANAlyzes the Boolean code pro- 
ducing the concordance. The results of the direct analysis are passed 
to J0SHUA, a routine which, with the help of BETH and GWEri, locates and 
prints out the sentences filling the logical request specified by the user* 

To interpret the Boolean form of the logical request, the user 
shpuld know that means "and", "|" means "or", and "^" means "not". 
Sets of parentheses are used to group sets of words together. 

In the event that an error is encountered in the processing 
of the request, PATTI or DIAI4A will print out a message indicating the 
error and the request is ignored. The inost common error will be one of 
ambiguity. Such errors are caught by DIAIlA which then prints out a 
brief message indicating the nature of the ambiguity. 
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Example of logical lequests include: 
REQUEST:L0CATE THE SENTENCES t^itH THE !J0RD ABLE. 
This sentence is then reported in Boolean code as 
ABLE. 

REQUEST: FIND THE 0CCURAKCES «5F B?5TH ABLE AI4D BAKER. 
The Boolean code for this request is 
ABLE6BAKER. 

PvEQUESTrriMD TIIF- S"N'TEnCES IIvT C0NTAIMIKG ABLE. 
This logical request is represented in Boolean code as 
7ABLE. 

Concordances can nlco be generated for semantic units (see the 
description of semantic units in the Index chapter). The logical 
request should indicate the label of the semantic unit and not the 
words contained in it. Using the sample semantic unit presented in the 
preceding chapter, the logical request 

REQUEST: FIND THE SEMTEMCES HITH SUOOl. 
would result in the printing out of all the sentences containing "UP TIGHT" 

9.5. Error Ilessa^cs in C0NC0PD 

In the execvtion of C':' IC0RD error messages may be printed out by 

ti-zo routines, CCfcC^?J) and JC^SIIUA.. The error messages are as follows: 

^<"'-ERRC5R (O.^NC^RO 1): 
UNREC«/jGMIZAr>LE ?AR.^HE^i:R FC'-l^ir. 

This me^rngc iadicc^tj.; that a parameter box contained a symbolic 
name other than thorc sp'-cif\ocl in the calling sequence for C^IC0RD. 
Change che incorrect: name and resubmit the job. 
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***ERR0R (C0NC0RD 2): 

N<iH m0VGll C0RE AVAILABLE. 

The core (memory) requirements exceed the core available. If the 
program is beinp executed under IIVT or IIFT, request more core and resubmit 
the job. Othervjise, see a consultant at the c^nputer installation* 

***ERR(iR (C<JNC0RD 3): 

THE TEXT, SENTLIST, flJR TfilRDLIST FILE NAIIES HAVE N<W BEKJ 
SPECIFIED. 

At least one of the three file names listed in the message was not 
specified in the parameter box. Specify the correct files and resubmit 
the job. 

***EPR0R (Cv fC0RD 4): 

THERE IS N0T ENOUGH C0RE P0P ALL THE DESIRED SEMTENCES, 
SEE PR(JGRAI^ TTITE-UP. 

More core (memory) is required for execution of the program. -than r 
is available. If execution is conducted under IIVT or ITFT, request more 
core and resubmit the job. Under other circumstances, see a consultant 
at the computer installation* 

***ERR0R (C«R4C0RD 5): 

THERE IS INSUFFICIENT SPACE AVAILABLE F0R THE SENTSTAK, SEE 
PR0GPAM !7RITE~UP. 

Ilore core (memory) is required for execution of the program than 

is available • If execution is conducted under irVT or irFT, request more 

core and resubmit the job* Under other circumstances, see a consultant 

at the computer installation* 

***ERR0R (JOSHUA) 

DESIRED SENTENCE HAS BEEN PASSED. 

Hake the logical request immediately preceding the error message 
in ihe printout the first request in the job and resubmit. 
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9.6. Routines Required for the Execution of C0HOfKD 

BEDRES, the input /outpuc routines, Gl.'EN, PATTI, BACKFILL, DIAi4A, 
J0SHUA, BETK, and C<iNC0ia) routines must be included to execute a 
concordance on a text. 

9* 7. Terminating Analysis of Datasets Through the Use of C0MC0RD 

W in the user of the BEDRES package feels that he has made full use 
of the capabilities of tliese programs on any particular dataset, C0UC0RD 
should be given a dumny iim to remove the codewords for that dataset. As 
presently conceived, the BLDRES package standardized the cualysis of any 
dataset by i.fcllizing unique codewords for each block of dcta. These 
codewords are sn-cifled by the user when the data are first loaded onto 
the disk. However, a record of these codewords is also kept on the disk, 
creating a potential problem of filling the disk space with codewords 
for data which are no longer under analysis. To prevent filling the disk 
with these codewords, the foll«/inc form of C^NC^RD should be run at the 
termination of data analysis of a given dataset. 

// EXEC BEDRES ,TEXT= ' textname ' , WORDNAM= 'wordname ' 

//C01J?™D'r"'"'^^'' '^'^^^'^P='(<^LD,DELETE)',SETl;ISP=.'(OLD,DELETE)' 

**C(»UC(?RI;(TEXT:TEXT,C0L:l-80) (WORDLISI rWORDLST) (SENTLISTrSENTLST) 
((OUTPUT:PRIHT,COL:2-80,79) (LENGTH:0,0) (PJ-QUEST-*) '^"^^'''^^T) 
REQUEST: LOCATE AA SENTENCES l-TITIl THE l/ORD ABLE. 
/* 

The parameter box labelled textncor:e should contain the name of the 
dataset which the use no longer wishes to analyze. The boxed labelled 
wordnam and sentname should contain the appropriate codewords for that 
dataset. Should the user wish to analyze this dataset In the future, it will 
be necessary to reload the data onto the disk from the original cards or the 
back-up tape, and to specify the codewords again. Refer to the section 
Q under COPY entitled "Loading Data Onto the Disk". "\85 
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APPENDIX A 

TRANSFERRING FILES FROM DISK TO 
TA^E AND TAPE TO DISK 

Purpose 

Most events that are associated with huznans are prone to error. 
Because of this fact it is useful to keep a spare or backup copy of the 
data files that are created with the BEDRES package. This can be expecially 
important when a large collection of data files has been created, and ae* 
cidental loss of them could be very costly in human labor» time and money. 

The BEDRES package is designed to work primarily with direct access 
stot4ge devices. This method of data storage is usually one of the more 
expensive. To maintain a backup copy on one of these devices would » indeed* 
be very expensive. A much more economical method of long-tern data storage 
is through the use of magnetic tapes* 

Most computer manufactures supply with their machines a set of utility 
programs that serve the purpose of data management. For our purposes , a 
program that will create a backup copy of our direct access device on 
magnetic tape would prove to be very useful in the event that an accident 
did occur. 

The Utility Proy>rari 

Creating the Backup Copy 

The example that follows is such a utility program provided by IBfl 
for their operating system on the IB?' System/360 computer. It involves 
execution of a program called lEHDASDR. The program copies a disk (in this 
example > DK0023) onto a standard label (an IBI* convention) magnetic tape 
(a25985) . 
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/*ID <accounting infonnation> ,I0REQ= 10000 
/*SETUP UNIT=TArE,ID=025985 
/*SETUr UNIT=DISK,ID=DK0023 
//DUMP EXEC PGrt=IEHDASDR 
//SYSPRINT DD SYSOUT=A 

//DISK DD UNIT=DISK, V4^L=Si'.R==DKOC23 ,DISP=0LD 

//TAPE DD U;UT=TAPE,V0L=SI:R=0259O5,DISP=4}LD,DSN*DKOO23 

//SYSL>S DD * 

DUMP FRCSiiDD=DISK, T(/DD=TAPE 

/* 

Restoring the Dish 

This program then serves to nove the contents of the disk onco 
magnetic tape for future use as a backup copy should it ever be needed (?.g., if the 
if the disk were broken) , 

If something does happen to our storage device then the following 
program will restore the disk to t:he same condition that it was when the 
backup copy was last created* 

/*ID <accountin8 infornation>,I0REQ=lOOOO 

/*SETUP U:aT=TAPE, 10=025985 

/^^SETUP UI>:iT=DISK,ID=DK0023 

//PvESK^RE EXI-C FGM=IEHDASDU 

//SYSPRINT SYS0UT=A 
• //DISK DD Ul>;rT=DISK,V(<)L=SLR=D[:OO23,DISP=0LD 

//TAPE DD U::iT=TAPE,Vt/;L=SER=?;25985J)ISP=0LD,DSW=DKOO23 

//SYSIN DD * 

REST^iRE FR(«MDD=TAPE T0DD=DISK 
/* 3^ 
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Deforc restoring a direct access device to the condition tUet it 
was laet In, it is important to take into consideration hovr much the data- 
sets on the device have been altered since the dump program was last run» 
and ho\/ much was accidentally destroyed. Obviously any datasets that were 
changed or added since the last creation of the backup copy will need to 
be redone if the RESTORE tape is used. 

If a large amount of datasct manipulation has occurred since the 
creation of the backup tape and it becoires necessary to restore the disl^ it 
might be useful to copy any of the newly created datasets onto some temporary 
storage device > restore the disk, then copy the newly created datasets back 
onto the disk, and finally replace the datasets that vrere destroyed, if any. 

It would be greatly desirable to run the DUIIP program whenever a 
significant number of changes have been made to the storage device such 
that rerunning these changes would be very costly in time and money* The 
ten statement DWfP program is easily run on the computer without any fear of 
destroying anything on the disk storage device. 
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Concatenation of data files 

The followinc is a brief sunniary of one of our uses of the BEDRES 
prograns . 

After a sizable nunber of notes fron the interviews had been key- 
punched fron various interviewers, it was desirable to enter then onto 
the disk before they had a chance to become displaced or confused with 
other notes* As the project cane to a close, a hu^e amount of data had 
been collected and placed on the disk. The data had been entered on the 
disk in no particular order, other than by placin<> the data into a file 
coded by the nane of the interviewer. 

Ilany of the interviev/s involved follow-up interviews, so it was 
decided to rearrange the data in each interviewer's file so that it 
v/ould be in chronolo'^.ical order, Jhis <^ave an order to our huf»e col- 
lection of data that would facilitate ethnof^raphic analysis and interpreta- 
t ions . 

Tliis process involved five steps: 

1. Look up the date of each interview and the sentences 
nunrbtfrs that it included. Do this for all of the data 
collected by each interviewer from a listinc^ of that inter- 
viewer's file??. 

2. Arranf*,e the interviex/s by informant and then arrange both 
interviews and fieldnotes in order by data. 

3. Use the EDIT program to rearran.o;e the interviews and field- 
notes by placino then in chronolor:ical order in a newly 
created file. 

89 



4. iJhen finished with rearranging the data, use the LISTER 
pror,ram to obtain a listinf^ of the netrly ordered Inter- 
viex7S and check for any errors. 

5. Delete the old files if they are no lonjer needed for 
any other reason. 

It should be noted that this process ran be used for putting 
the files in any kind of order. Thus, if a case study was made in a 
particular area, or on certain people, the files vxl^Jtxt be ordered to 
reflect the nature of the study. After creation of the new files, 
KIDEX and C0MC0RD can be used, if desired. 
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APPENDIX C 

OBTAINING STORED FILEl>IAMES AND CATALOGING 

Obtainint^ Data Filenames Stored on Disk or Tape 

After the BEDRES iiser has placed a considerable amount of data on 

either the disk and/or back-up tape, it nay be useful to obtain a listing 

of all datasets found on these stora^,e devices. This is acconplished by 

obtainin|> a list of all datasets (by filenane) which the user has placed 

upon the disk or tape. Such a listinr^ is nade available by calling for 

a copy of the Volune Table of Contents (VTOC) found on the disk: 

/*ID<acccunting inf cntat icn> ,Lines=20000 , 

/*I0REQ=5OOO,TI>:E=4 

// SETUP,UNIT=DISK,ID=DK0023 

// EXEC LISTDISK 

//DDI DD UNIT=2314,VOL=SER=DK0023,DISP=OLD 

//SYS IN DD * 

/* 

Should the user wish to obtain the VTOC for the back-up tape, the 
data is simply switched from tape to disk (as outlined in Ap.B) and the 
above program ±z run. 
Catolo^ Procedure for BEDRES 

The speed, sinplicity, and effectiveness of the BEDRES prosrans also 
depend upon the Catolo^r Procedure, since in its sinplest form, the Catalog 
Procedure serves the function of settin- up the BEDRES package on the 
conputer in asable forr. wit' cut special instructions from the user. 
Should the catalog procedure be improperly altered or destroyed, the user 
of BEDRES would be required to find professional assistance In running 
the BEDRES pro^rans. For this repson, the user of BEDRES is urged not 
to nakc chan-es in the catalog procedure listed below unless najor revi- 
sions in the labeling or operation of the BEDRES proRrans are desired. 

Er|c 91 



86 



7 PPOC TEXT«= ' TRIP • ,i:ORDISP= ' SHR' ,TEXTDSP= ' SHR ' .SETDISP- ' SHR ' , 
7 SENTNAII* 'SENTNAII' ,WORDNAII= MSORDNAI^' 
7 EXEC PGM=BEDRES,REGI0N=348K 

/STEPLIB DD UNIT=DISK,VOL«=SER»DK0023,DSN«USES.P2103.BEDRES,DISP-SHR 

/PRINT DD SYSOUT»A,DCB=(LREa=133,RECFrteFA) ' 

/TEXT DD DSN»&TEXT,l]NIi=DISK,VOL=SEP.«»DK0023,DISP-&TEXTDSP, 

7 SPACE=(Tm(,(4,4)), 

7 DCB»(LRECL«80,BLKSIZE=800 ,PECFM=FB) 

/UORDLST DD DSN»&F0RI»IAi:,l)NIT=DISK,VOL»SER«DKO023,DISP««TOPDISP , 
7 SPACE«(TRK,(4,4)), 

/ DCB= (LRECL-24 , ELKS IZE=240 , RECHt=«FB) 

/SENTLST DD DSN=&SENTNitt' ,UNIT=DISK,VOL»SEP=DK0023,DISP»&SETDISP , 

/ SPACE«(TRK,(4,4)), 

/ DC&= (LRECL- 80 , ELKS IZE«800 , PJiCE '= FB) 

/INPUT DD DDNAIIE" CONTROL 

/CARTi DD DDNAIT*CARDS j 

/CHANGE DD DENAME-CHANGBS 
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Tiiiit '>,lossarv is designed for the naive user and assumes 
no nrior Icno^^ievlga of cornuterr> in pcneral and snecif icallv, IB?' 
Syr>tGn/3r)0. Conscnuent 1", man^ the definitions-, lack the teclmical 
rif^or renuired L-v nersonc faniliar rith connutin.f> nachinerv. 

."nciior "or J 

In a :10^^I^'Y ciian^.c* snocifiod for t'-.e EDIT nro^ran, any vord 
^•Mch i.-. not ]^cln^ nodified but is used to indicate the position 
of the ';ord(s) to be luodifiefi is an ancl^.or ^-ord . 

Assemble 

The procedure by \^]>ich a source -^ro.^rar, is "translated*' into 
code ich Cr>n be executed, ^ce sourc e pro<-^rain and object 
I 'ouule belov'. 

As t> e !*"ib 1 e r L an u a ^ ? 

Tiwi raciiine orit?ntcd Ir.n-ur.^-e for i::*'" SvcterVBGO in \;hich the 
i;CD?r.S Pac!:a'^o orof^^rnr -. are vritten. 

Auxiliary Stora.^e Dovic' 

Anv device ^-'.ic^. car bo u''.c.i to store infom.'ition but is not 
an inte'^ral nart o-" tlu> co"7Hitcr. Such devices must be 
•lounted on ti;e c .">uter before tl .^v can he utilized, 

I5Li;SIZC 

i:ecor({s arc of'ten '-^rouned together into blocl'S, In the Data 
Control ^loc\ (DC), ..UlSlZL indicates t'la number of bvtes 
in such a bioci". 

boolean One rat or 

In the nroduction of concordances, tl.e uscv'^: lo'-ical reouests 
are tran'^lated into i^ooloan state: ent.s. Yho relationshx-^s 
betT/een the ^n^rds rcouested are renronuntod h^' the operators 
and (O, or (|), and not (-;) — t'.c I^oolean or>crators > 

^yte 

The unit of core (^^c:'or^O ronuired to represent one character. 

Card Cclunn (cc) 

An I i" card v. vlivided into '*'0 vertical colui^n.o ir: ich 
characters may >,e ntmchcd at n rate o^ one c.ir^racter nor column. 
The character nunchcd Lf^ usuallv -jrLnted out at t!ie head of 
tlic colupn, Hach column is called a card column and is 
identified bv a number indicatin'^ its ])ositic'n on t!'o card. 
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Carriage Control 

!Jlion records are sent to the nrinter, i.e*, uben records 
are to be nrinted out, the first cliaracter of each record 
is used to indicate uiiether the nrinted lines are to be 
sinrrle, double, or trinle snnced. The first character of 
each record is said to snecify carria<>e control . 

Concordance 

A listin:^ of all the sentences containing a vrord or 
constellation of ''ord*^' snecified bv the user. The List- 
ing may include a ce* ain nunbcr of sentences preceding 
and follow ini^' each 5. A\ sentence. 

Control Card 

Any card specif yinft to the connucer*? oneratinj^ system 
T7hich job stens (e.n^> assemble, link edit, or execute) 
are to be r>erforr.ed, or defliiinn a file to be used ^^ith a 
snecified job steo. 

Convention 

An arbitrary definition or nrocedure snecified for sone 
purpose. An examole in the BnOPES Packar^e is the defini- 
tion or a sentence as any striar of characters teminated 
by a neriod and the end o^ a line or a noriod and at least 
one blank snace. 

Core 

The part of a cor.nuter in "'lic!^ infornh^tion is stored. The 
infornation nav be data or instructions. 

Data Control r>locl: (DCr;) 

The nortion of a file dcfinin'>. control card -i\ich provides 
information rep:ardinf> ho-- data Ls stored on that file. The 
DCD nnccifies t];e length of each record (LRECL) , the 
number of bvter, in each biocl: (DLyf^ZE), and the format of 
the records C^rCT'^*). 

Data Definition (DD) 

A type of control card definin'- a file for a f^iven job step. 
The :>!) card descrjics tikC flics to t^ic oneratin'^ syrsten. 

Data set 

A set of records -.'liick is storec! on a device ruch as a disk, 
tane, or deck of cards. 

DD name 

The name u^tod on the nrop.ram control card and the Di) card to 
identify a data cet uccd in the execution of a nackaf;e pro<>rarp. 

Default Option 

If certain oaraneter boxe^ are mt s^^ocific^d uj^en a BDDRCS 
nacka'^^e nro'>,rap is to bo executed, tlie nro'^rai: assumes nnat 
particular "^iles or options are to be used. These files or 
ontions are tiie dof au' t ontions. See tlie nrop,rara chanters in 
this manual for a descrlnflon o^ tlie default ontions for each 
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Direct Access Device 

Anv auxiliary stora^^^e device rhici> allovs the user to access 
inforraation at any location on the device x;ithout havinf* to 
start at the befinnin,'^,. 

Disk 

A 3roun of metalic disks uith na'^necic surfaces or* \7i:ic'> inforration 
can be stored. 

DISP 

On a data definition card. Disp osition indicates u'r.at is to be 
done uitli the data set defined in file represented bv the DD 
card. The disnosition indicntoo ^\ether the data set is old, 
ncu or to be modified, and uhethov it. should be retained (kept) 
or deleted. 

DSIJA* IE 

Tlie name o^ a data set. The DSMA"E is nnecified on the data 
definition card. 

Execute 

Execute refers to tlie job stv^^D in uliich the task for T;hich 

a given DEDP.ES PacTcap.e nror.raHi \?p3 designed is actually accomplished. 

EXPLETIVE 

Any of a .set of ^.^ords often uned because of and to describe an 
unsuccessful run on tlie comnuter. These !'ords include -^-VVc^ •A-«r)!t;V^ 
and 

Extended Binorv Coded Decimal Interchange Code (EBCDIC) 

The name of tiiC nattcrn of nunches used to represent characters 
on 1.;:' cards for the i;>:i ryr.:er7360. 

File 

A data set defined for use in sone sob step. 
Format 

An indication of vhcre on a record infomation can be read or 
written. 

Oarbare In Oarbage Out. Prefers to notl-in:* neaninjful 
resulted frop t!io nrocessin'^ o^ sopo data. 

The execution io'^ ste^^. 

Hard Conv 

lir cards or ormtout. 



95 



IBIl Card 

A soeciallv cut and -printed card ^ncle of licnvv stoci; uliich 
can be nunchod on n I^eyDunch nnd road b^^ a card reader • 

Index 

A listin*: o^ the ^'ords ar^ncc^rin'^ in a set of data and tha 
nunlerr. of tlie sertencoe: in rlucli each a^nears. 

Input/0utT)ut (1/0) 

Hcfers to the ^>roccdures for ^ettin^" information into and out 
of tiic connuter. 

Job 

A tas!: to be ncrfomed bv tl^e connuter. 

Job Preparation 

The orenaration of a joh is tho collection and or.'^anization 
of control cards, pro^rar. cards, anvl data as a prelude to sub- 
mitting tlie job to tho cor.nuter to be executed. 

Job Step 

Each step in the execution o^ a tasl. is called a job step . 
G0 is an exanolc of n job sten. 

Keypunch 

A machine used to nuncl: IT' cards. ICevnunch. may also refer to 
the act of rjunch.inf' cards. 

Link Edit 

Tlie job step in nhiclr object modules are orp;anized nrenaratory 
to their execution. 

Load ilodule 

A set of object modules thnt have been processed bv the linlcage 
editor and arc read^' to be execute!. 

Logical Record Lenft«i (LRI-CL) 

The nupher of b^'tes k.c!\Trpcter'0 in a record. LRECL is 
snecified in the data control bioc'-. on a data definition card. 

Logical "enucst 

A rc^iiosl to th.* D/-:*C(/".l '^ro'^rap indicatin-^ vl ich T7ord(s) is 
(cxre) to be "roncordc/.^coti' . 

llemorv 

Gee Core . 

IIFT 

!Iultiple ^i::ed Tao!: (i'TT) is an oneratinp; svster* under x;hich 
several jobs can bo nroccssed sir.iultaneou^lv !)v the connuter. 

Under !'PT, core is divided Into n.-^rtltionc of fixed size and the 

jser requests a nnrtition lar^e enou^^l: to handle liir: job. 
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:-VT 

Multiple Varinble Ta.oL C'^T) is nn onc^-atin.'^ svster under t;hich 
several lobr. can he nrocesned HJinuicnneouslv by the computer. 
Under : VT, the ur.er snecifier. lu)r much core, his jo!; requires and 
tltat nucii core is allocnted for liin', 

ilCAL 

'•CAL is a naraneter for tl>e li:x\: editing ste-^ indicating th.-^t 
nrof^rnri'^. mav \.c pontioned Ir r'ci ohiect modules ^']>lch do not 
a')near in tha jo!* heinf^ lini: edited. If i'CAL is not specified 
in a :;i:o :r,^ f^acUnpe jol-, tiie run -nil terr;in'»te nrematurelv. 

Object Dec!: 

An obi<'Ct r>0(!uk: munched on cu-dr.. 

Object "odule 

'.lien a source nro^ ran io asnomhled, the '"translated" version of 
the -^ro'-r.in is referred to nr. an object nodule. The object module 
is the ver.sio/. of the: nrcrap r'»icr. ir, .-actually executed, 

Oneratinf Svstcn 

The oneratia<^ ^^vstcr is tho pro'>,rar:P:in^ ''".icb. nonitors and controls 
the cor>-^utar'<: functioning'. The ui^.er siiouii: see a consultant 
at his comniiter insLallPtion for information refardin^* the 
oneratinf; svsten under »'i*icb. his -^ro^r^-^rrs onerate, 

Paraf ra->!» 

i'EDmf^ '^acl.a'^r* convention dofi ios a - •ra":r ap!: as a strin'^ of 
characters ilu- first five c r.racteri, o*" t'')ic:! are blank. 

Parameter Cox 

A parameter bo:: Ls a Pair of* left a:v! rL'-iht 'parentheses con- 
nainip.'^ inforrintion to be vis.^o:! tr. ono oC t:»o ISHDRLS package 
nrof^^r;*^'!^.. 

Printer 

The outnut device rl.ic!. nroduces the :>riniout. Occasionally, 
printer refers to the file \'bic!^ vill be nrinted out; the file 
^v.ich is sent to tl'.c r^rinter. 



Printout 

Printed otitnwt fror the-. cor->r.tor. 



Prc.rar. 

A s'*r o^, instruclio.v. -l.Tr - ' ill bo TH>rf or-M^I b^' the connuter. 

Pro'^ram Control Card 

A Pro-:ran control (vi*^d on • ic' ip(N'cate5; to nnon!:^ tfhich of 
tlie n.^cliar.e nro^.rans ir. to ]).; e::ecuted, TIm card l)e".ins x/ith Vjo 
stars ('*••>) cc i-2 an! tl.? 'irst: four c>,rractcrs of the nro.rram's 
name in cc ^oUorin'* the -vo-ran name arc tiie nnraneter boxes 

described i.i r.!ie orofra;.'^; climter in thi:;; manual. The nrop.ram 
card IS ter~:inaiC(^ hv r ••^jricn!. 
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Punch 

As a verb, nuncli refers to the act of hevnunchin'* of the nro- 
duction 0^ munched cards bv th.e comnuter, as in the case of the 
object dec!:, rs a noun, it refers to the oiitnut device on the 
connuter ^viioh -produces card? or t\\o. kevnunch. 

Read 

The procedure bv *vicii t]\c cor^^uter exanines records nickinj* 
un the information thev contain. 

vxcr/ 

refers to PECord ]^or'Jat. HECF: ' ir. a narar.eter on the data 
definition card indicatinf^ the ranner in *;hicl> the file*p records 
'are orf^anized. indicates thv-^t the format is constant for all 

records, indicates that records are bloc!:ed, and "A" i,ndicates 
that the first ch..^.rncter of one-: record is to be used as carrinp:e 
control. 

Record 

/. record i:> a strin*^ of ccntif*uous charactero, usually of sone 
specified length. Lino is ;5 ovnon;j^ for record . 

Record Len^^th 

The nunber of bytes (cii^racters) in a record. 

P.outine 

Synon^n for n roe ran . 

Semantic Unit 

A senantic unit is a groun of i:n to ten contiguous xjords without 

intervening, Dunctuation r.arl;s defined bv the ur.cr as bein*^ of 
SDCcial interest. 

Sentence 

liEDRLS Pachaf^e convention defincn a sentence as bein'' a string of 
characters terminated bv a oeriod, question mark, or exclamation 
point and the end of the line or at least one blank. 

CERial number rcfarn to the identification numl er of sone device 
such as a disi:. 

Source Listin: 

The cornuter produce? a printout indicating* the location of a 
source nro'^.ran'*? instructions in core during the nrocesn of 
assemblin<^ the r.ource nrof^rar. This nrintont is called a source 
listinf> . 

Source Proj^ram 

A source nro.^^ran is a nro^ram before it has been assembled. 
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Stackin'^ 

Stachinr is the runninf^ of several nrof>rams from the sape job 
clecl:. It is acconnlishod b^' sncciFvinf; the proj^ran cards for 
each nro^ran in the job deci: in the order in Tjliich the nror.rams 
are to be executed. 

Stylistic Analysis 

As defined bv the I^OPXS Paclva^e, Gt^^Listic analysis is the 
examination of sone set of cita usinf'. tho sentence structure, 
nhrase, and \;orcl choice considerations described in the chapter 
on Son of '^OVSr,, 

Tape 

A ina^netic ta^c, not unlike th.oso used on tape recorders, on 
rhich information can ho srtorcd. 

T0L0:i0 

A snail to^'n on ^oute '*5 south of Chamnaif^n. 
Truncate 

Certain of the BEDHES Pachaf'O oro[>.raps define T:ords as being no 
lon[;er than 16 characters. Only the first 16 characters of uords 
17 characters and lonf^er are used hv si:ch oro'^rams. Such uords 
are said to be truncated to 16 diameters. For exarmle, the nord 
A::TIDISnSTA3LISIi::i:::TAniA:!I^^^ \:ould be truncated to AIITIDISCSTABLISII . 

UIIIT 

Any device such a^^ a tanc or disk.. 

Unit record Device 

Any device t/.ticii handles "hard conv"; unit record devices include 
card readers. , card nunchos, and printers. 

V0L 

VOLume is synonynous xrith device and refers to a taoe, disk, etc. 
Iflieelbarrot; 

A unit of measure of datp. .\ ^^heeIbarro\: c orresponds roughly to 
"an aT/ful lot", 

'rite 

The nrocodurp b*' '^iici\ tMe cor'-^uter nuts records on sone device. 
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